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PREFACE 


The MVS/Extended Architecture System Logic library is intended 
for people who debug or modify the MVS control program. It 
describes the logic of most MVS control program functions that 
are performed after master scheduler initialization completes. 
For detailed information about the MVS control program prior to 
this point, refer to MVS/Extended Architecture System 
Initialization Logic . For general information about the MVS 
control program and the relationships among the components that 
make up the MVS control program, refer to the MVS/Extended 
Architecture Overview . To obtain the names of publications that 
describe some of the components not in the System Logic Library * 
refer to the section Corequisite Reading in the Master Preface 
I in MVS/Extended Architecture System Logic Library? Master Index . 


| TRADEMARKS 


The following are trademarks of International Business Machines 
Corporation. 

• MVS/DFP(TM) 

• MVS/XA(TM) 


HOW THE LIBRARY IS ORGANIZED 


SET OF BOOKS 


The System Logic Library consists of a set of books. Two of the 
books provide information that is relevant to the entire set of 
books: 

1. The MVS/Extended Architecture System Logic Library: Master 
Index contains the master preface master index for the other 
books in the set. 

2. The MVS/Extended Architecture System Logic Library: Module 
Descriptions contains module descriptions for all of the 
modules in the components documented in the System Logic 
library. 

Each of the other books (referred to as component books) in the 
set contains its own table of contents and index, and describes 
the logic of one of the components in the MVS control program. 
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Most component books contain information about one component in 
the MVS control program. However, some component books (such as 
System Logic Library: Initiator/Terminator ) contain more than 
one component if the components are closely related, frequently 
referenced at the same time, and not so large that they require 
a book of their own. 

A three or four character mnemonic is associated with each 
component book and is used in all diagram and page numbers in 
that book. For example, the mnemonic ASM is associated with the 
book MVS/Extended Architecture System Logic Library: Auxiliary 
Storage Management . All diagrams in this book are identified as 
Diagram ASM-n, and all pages as ASM-n, where n represents the 
specific diagram or page number. Whenever possible, the 
existing component acronym is used as the mnemonic for the 
component book. The Table of Book Titles in the Master Preface 
I in MVS/Extended Architecture System Logic Library: Master Index 

lists the book titles, the components included in each book (if 
a book contains more than one component), the mnemonics for the 
books, and the order number for each book. 


HOW TO USE THE LIBRARY 

To help you use this library efficiently, the following topics 
cover 

• How to find information using book titles and the master 
index 

• What types of information are provided for each component 

• How to obtain further information about other books in the 
System Lc^ic^Library 


FINDING INFORMATION USING THE BOOK TITLES 

As you become familiar with the book titles, MVS component names 
and mnemonics, and the book contents, you will be able to use 
the System Logic Library as you would an encyclopedia and go 
directly to the book that you need. We recommend that you group 
the books in alphabetical order for easy reference, or, if you 
are familiar with MVS, that you group the books by related 
functions. 

I The Table of Book Titles in the Master Preface in MVS/Extended 

Architecture System Logic Library: Master Index contains a list 
of book titles and mnemonics. It provides a quick reference to 
all the books, and their corresponding components, in the System 
Logic Library . 


FINDING INFORMATION USING THE MASTER INDEX 

If you are not sure which book contains the information you are 
looking for, you can locate the book and the page on which the 
information appears by using the master index in System Logic 
Library: Master Index . For the component books, the page number 
in an index entry consists of the mnemonic for the component and 
the page number. 

For example: 

ASM-12 refers to MVS/Extended Architecture System Logic 

Library: Auxiliary Storage Management , page ASM-12. 
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INFORMATION PROVIDED FOR MOST COMPONENTS 


The following information is provided for most of the components 
described in the System Logic Library . 

1. An introduction that summarizes the components function 

2. Control block overview figures that show significant fields 
and the chaining structure of the component's control blocks 

3. Process flow figures that show control flow between the 
component's object modules 

4. Module information that describes the functional 
organization of a program. This information can be in the 
form of: 

• Method-of-Operation diagrams and extended descriptions. 

• Automatically-generated prose. The automated moduie 
information is generated * : rom the module prologue and 
the code itself. It consists of three parts: module 
description* module operation summary* and diagnostic 
aids. 

5. Module descriptions that describe the operation of the 
modules (the module descriptions are contained in System 
Logic Library: Module Descriptions ) 

Some component books also include diagnostic techniques 
information following the Introduction. 


FURTHER INFORMATION 


For more information about the System Logic Library# including 
the order numbers of the books in the System logic Library , see 
the Master Preface in MVS/Extended Architecture System Logic 
Library: Master Index . 


LY28-1670-1 


(c) Copyright IBM Corp 


1987, 1989 


Preface v 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


vi MVS/XA SLLt Dumping Ser 


LY28-1670-1 (c) Copyright IBM Corp 


1987, 1989 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 

CONTENTS 


Dumping Services DMP-1 
Introduction DMP-3 

Formatted and Unformatted - Abend Dumps DMP-3 
Unformatted Dump - SVC Dump DMP-4 
CHN6DUMP Operator Command DMP-4 
Formatting Specific Control Blocks DMP-5 

Data Management Control Block Formatter DMP-5 
IOS Control Block Formatter DMP-5 

Diagnostic Techniques DMP-7 
SVC Dump Debugging Aids DMP-7 

Important SVC Dump Entry Points DMP-7 
SVC dump Error Conditions DMP-8 

SYS1.L0GREC Entries Produced for SVC Dump Errors DMP-9 
Control Blocks Used to Debug SVC Dump Errors DMP-14 
SVC Dump Data Area (SDDAT) DMP-16 
Resource Cleanup for SVC Dump DMP-16 

Process Flow DMP-19 

Method of Operation DMP-49 

IEAVAD00 - SVC 51 Overview DMP-54 

IEAVAD00 - SVC Dump Processing DMP-56 

IEAVAD01 - Snap Dump Processing DMP-68 

IEAVTABD - ABDUMP Processing DMP-82 

IEAVTDSV - DUMPSRV Address Space Jobstep Task DMP-92 

IEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) 

Processor DMP-94 

IEAVTSDR - SVC Dump/DUMPSRV Resource Manager DMP-110 

IEAVTSDT - Resident Dump Task Processing (IEAVTSDT) DMP-116 

IEAVTSDX - Schedule Dump Processing DMP-122 

IEAVTSDX - Schedule Dump SRB Processing DMP-130 

IEAVTSEP - SVC Post Exit Processor DMP-134 

IEAVTSRB - SVC Dump SRB Routine DMP-136 

IEAVTSSD - Summary Dump Processing DMP-152 

IEAVTSSV - Suspend Summary Dump Processing DMP-160 

IECDAFMT - Data Management Formatter Mainline DMP-164 

IECIOFMT - IOS Formatter Mainline CIECIOFMT) DMP-168 

IEECB867 - SVC Dump Reason Code Text Processor DMP-174 

index 1-1 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 


Contents vii 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 


viii MVS/XA SLL* Dumping Ser 



"Restricted Materials of XBM" 
Licensed Materials - Property of IBM 

ENSURES 


1. Abnormal End-of-Task DMP-20 

2. ABEND/SNAP Dump Processing DMP-23 

3. SVC Dump Overview DMP-25 

4. Formatted Dump Module Flow DMP-28 

5. Summary SVC Dump (SUMDUMP) Formatter for the AMDPRDMP 
Service Aid DMP-32 

6. Synchronous Unformatted Dump Module Flow DMP-33 

7. Scheduled Unformatted Dump Module Flow. DMP-37 

8. Master Trace Dump Exit Processing DMP-45 

9. RTM Services Module Flow DMP-46 

10. Data Management Control Block Formatter DMP-47 

11. IOS Control Block Formatter DMP-48 

12. Key to Hipo Logic Diagrams DMP-49 

13. Key to the Logic Diagrams DMP-51 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 


Figures ix 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


x MVS/XA SLL: Dumping Ser 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 

SUMMARY OF AMENDMENTS 


| Summary of Amendments 

| for LY28-1670-1 

I for MVS/System Product Version 2 Release 2.3 

This major revision contains changes to support MVS/System 
Product Version 2 Release 2. 

The following changes have been made: 

• MVS/Extended Architecture Data Facility Product CMVS/XA DFP) 
Version 3 Release 1.0, which introduces the storage 
management subsystem (SMS). SMS provides new function for 
data and storage management. 

• Modifications to the Diagnostic Techniques section, 
including new and changed information on: 

— SVC dump debugging aids 

• Changed information in the Process Flow section. 

• The following changed modules in the Method of Operation 
section: 

IEAVAD01 

IEAVTABD 

• The Preface has been updated to include the new title for 
the MVS/XA System Logic Library: Master Index and the 
deletion of the index from MVS/XA System Logic Library: 
Module Descriptions . 

• Minor technical and editorial changes throughout the 
publication. 


Summary of Amendments 
for LY28-1670-0 

MVS/System Product Version 2 Release 2.0 

This publication is new for MVS/System Product Version 2 Release 
2.0. It contains information that was reorganized from the 
Dumping Services section in MVS/XA System logic Library Volume 
6, LY28-1227-2, which applies to MVS/XA System Product Version 2 
Release 1.7. 

This publication contains changes to support MVS/System Product 
Version 2 Release 2.0. The changes include: 

• The addition of information on the SVC dump data area, 

SDDAT. 

• The following new modules: 

IEAVTSRB 

IEECB867 

• The following changed modules: 

IEAVTSDI 

IEAVTSDR 

• Minor technical and editorial changes throughout the 
publication. 
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INTRODUCTION 


SVC 51 produces the following types of dumps: 

• Formatted system dumps (SYSABEND/SYSUDUMP). 

• Unformatted system dumps (SVC Dump). 

• Unformatted abend dumps (SYSMDUMP). 


FORMATTED AND UNFORMATTED - ABEND DUMPS 

SNAP/ABDUMP is a subcomponent of the recovery termination 
management (RTM) component. 

The SNAP routine is invoked by a SNAP macro instruction, which a 
user program can issue at any time to obtain a dynamic dump. 

The SNAP macro instruction, whose expansion contains an SVC 51, 
causes the SVC second level interrupt handler (SLIH) to call the 
SVC Dump routine. The SVC Dump routine checks the SNAP 
parameter list to determine whether a SNAP macro instruction has 
been issued. If so, the SVC Dump routine passes control to the 
SNAP routine. 

The SNAP macro instruction can also be issued by an abend dump 
during abnormal termination. In this case, the ABDUMP routine is 
invoked, causing either a SYSABEND or SYSUDUMP formatted dump to 
be produced. (The ABDUMP routine can also cause a SYSMDUMP 
unformatted dump to be produced.) The ABDUMP routine causes the 
type of dump specified on the corresponding DD card to be 
produced. Thus, SNAP processing can provide either a formatted 
abnormal dump or a formatted dynamic dump. The dump produced by 
ABDUMP is governed by a combination of either: 

• The default dump options as specified in the SYS1.PARMLIB 
member for the specified dump type 

• The options specified on the CHNGDUMP operator command 

• The options specified by the SNAP macro instruction in the 
ABEND, CALLRTM, or SETRP macro. 

Figure 2 on page DMP-23 shows how ABDUMP determines the content 
of the dump to be taken based on the requested dump options. 

The SYS1.PARMLIB default dump options for a SYSABEND dump 
consist of the major control blocks belonging to the task, 
enqueue control blocks, LSQA (local system queue area), programs 
and dynamically obtained storage, the GTF and trace table 
entries, and summary dump. For a SYSUDUMP dump, the default 
consists of only the summary dump. See SPL: Initialization and 
Tuning for further information. The default SYS1.PARMLIB dump 
options for SYSMDUMP are NUC, SQA, LSQA, RGN, SUM, SWA, and TRT. 

These default options reside in the SYS1.PARMLIB members 
IEAABD00 for SYSABEND, in IEADMR00 for SYSMDUMP, and in IEADMP00 
for SYSUDUMP. ABDUMP processing merges these options with those 
specified on the request. 

If a dynamic dump is requested (the SNAP macro is issued by a 
user program), the storage areas to be dumped are specified by 
the operands of the SNAP macro. (See SPL: Supervisor Services 
and Macro Instructions for information on how to obtain a dump.) 
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The use of the SNAP routine is restricted to tasks that do not 
have job-step tasks within their subtask structure at entry to 
SNAP processing. If a task has a subtask that is a job-step 
task, control is returned immediately to the caller. Storage 
areas (storage, save areas, and the like) are dumped by SNAP in 
the current addressing mode of the issuer of the SNAP macro 
instruction. Storage areas dumped by ABDUMP are in the PSW 
addressing mode at the time of the error. Addresses are 
therefore 24 bits or 31 bits, depending on the current 
addressing mode. 


UNFORMATTED DUMP - SVC DUMP 

The SVC Dump service provides a quick, unformatted dump of 
virtual storage directly to a data set. To use SVC Dump, 
callers must have APF (authorized program facility) 
authorization, or be in control program key. The SDUMP macro 
instruction calls SVC Dump processing either by SVC 51 or branch 
entry. 

The SVC 51 routine dumps the contents of virtual storage from 
the address space in which the request occurred-operating under 
the caller's task-or it initiates the dump of another address 
space by posting the permanent dump task in the destination 
address space being dumped by scheduling an SRB and operating 
under the dump task. 


CHNGDUMP OPERATOR COMMAND 

The CHNGDUMP operator command allows the operator to change the 
system dump options. (See System Commands, for a complete 
description of the CHNGDUMP, DUMPDS, DISPLAY DUMP, and DUMP 
operator commands and their uses.) 
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FORMATTING SPECIFIC CONTROL BLOCKS 


This section describes how specific control blocks are 
formatted. 


DATA MANAGEMENT CONTROL BLOCK FORMATTER 

This formatter is called as a TCB exit from AMDPRDMP when the DM 
verb is used, or by SNAP/ABDUMP, when the DM option is 
specified. It formats the data management control blocks 
associated with each TCB. The control blocks that are formatted 
are: 

• DEB — The data extent block is formatted when the DEB chain 
is available and SNAP/ABDUMP is the caller. 

• DCB — The data control block is formatted when the 
associated DEB formatted successfully, the DCB is available, 
and SNAP/ABDUMP is the caller. AMDPRDMP calls this 
formatter if the associated task was terminated. 

• IOB — The input/output block is formatted when the DCB 
formatter returns a zero return code and the IOBs are 
available. 

• ICB — The interrupt control block is formatted when the DCB 
formatter returns a zero return code, the access method is 
SAM or BPAM with chained scheduling, and the ICBs are 
available. 

• LCB — The line control block is formatted for the TCAM line 
group access method when the DCB contains a zero return code 
and the LCBs are available. 


IOS CONTROL BLOCK FORMATTER 

This formatter is called as a TCB exit from AMDPRDMP when the 10 
verb is used, or by SNAP/ABDUMP when the 10 option is specified. 
If formats the IOS control blocks associated with each TCB. The 
control blocks that are formatted are: 

• EXCPD (XDBA) — The EXCP debugging area is formatted 
whenever available and when SNAP/ABDUMP is the caller. This 
area is also formatted for an abended task when AMDPRDMP is 
the caller. 

• UCB — The unit control block is formatted for each DEB in 
the DEB chain whenever available and when SNAP/ABDUMP is the 
caller. The UCB is also formatted for a terminated task 
when AMDPRDMP is the caller. 
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DIAGNOSTIC TECHNIQUES 


SVC DUMP DEBUGGING AIDS 

The SVC dump function is invoked when the SDUMP macro is issued. 
SVC dump produces dumps of system errors on a SYSl.DUMPxx or 
user-defined data set. SVC dump also produces abend dumps 
requested by SYSMDUMP DD statements. 

Items that are important for you to understand when debugging 
errors in SVC dump processing are described in the following 
topicss 

• Important SVC dump entry points 

• SVC dump error conditions 

• SYS1.L0GREC entries produced for SVC dump errors 

• Control blocks used to debug SVC dump errors 
Resource cleanup for SVC dump 


IMPORTANT SVC DUMP ENTRY POINTS 

The BRANCH 5 parameter on the SDUMP macro determines the SVC dump 
entry points and mainline processing to be used. 

BRANCH=YES Option 

Entry point IEAVTSDX is used for branch-entry SVC dumps. 

IEAVTSDX creates a summary dump in a real storage buffer (if the 
SUMDUMP option is requested on the SDUMP macro), schedules an 
SRB to invoke task (IEAVTSDT) processing to start the dump, and 
then returns control to the caller. 

The branch entry option is requested by many FRR routines and 
some ESTAE routines. This option is also requested when 
ACTION=SVCD is specified on the SLIP command. 

This option can only be used by routines running logically 
disabled (PSW disablement, locked, SRB Mode, or Super Bits Set). 

BRANCH=NO Option 

Entry point IEAVAD00 is used for the SVC entry to SVC dumps. 

The dump becomes a scheduled dump if any of the following 
schedule dump options occur in the parameter list< 

• The ASID or ASIDLST option is specified. 

• LISTA is requested. 

• TYPE=XMEM or TYPE=XMEME is specified. 

• SUBPLST is specified and contains an ASID other than the 
current ASID. 

These options force a scheduled dump because they request data 
in an address space other than the current address space. For 
scheduled dump requests. IEAVAD00 calls IEAVTSDX (through 
routine IEAVTSGL), which schedules (or causes to be scheduled) 
one or more SRBs to invoke the dump task (IEAVTSDT) processing 
for the requested address spaces. After scheduling the SRBs, 
IEAVTSDX returns to IEAVAD00, which then returns to the caller. 

A synchronous dump request is an SVC-entered SDUMP which does 
not contain any of the scheduled dump options. For synchronous 
dump requests, IEAVAD00 processes the dump and then returns to 
the caller. 

The SVC entry is requested by many ESTAE routines. It is also 
requested by the DUMP command (as a scheduled dump), and by the 
abend dump processor (IEAVTABD) for SYSMDUMP DD statements (as a 
synchronous dump). 
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Determining the SVC Entry Point 

The title line produced for SVC dumps that are formatted by the 

print dump service aid indicates whether a scheduled or 

synchronous SVC dump was requested as follows: 

• If "MODULE IEAVTSDT" is in the title line, the dump was 
scheduled (SDUMP BRANCH=YES or SDUMP BRANCH=N0 with one or 
more of the schedule dump options)* 

• If the title line contains "MODULE SVCDUMP", the dump was 
synchronous (SDUMP BRANCH-NO with none of the schedule dump 
options). 

• If the title line contains "MODULE modname", the dump was 
synchronous SDUMP or SYSMDUMP and the module name "modname" 
was found in a CDE or LPDE entry. 

• If another module name is in the title line, then the dump 
was synchronous. SVC dump was able to determine which load 
module invoked it and insert the name in the title. 


SVC DUMP ERROR CONDITIONS 

If the SVC dump function encounters an unexpected error during 
its processing, it produces a software SYS1.L0GREC record and, 
if possible, continues taking the dump. 

Expected program checks can occur when SVC dump is checking 
whether a virtual page that is to be dumped is valid and 
assigned. These program checks do not result in SYS1.L0GREC 
entries. 

SVC dump issues abend 133 if it detects an unauthorized caller 
or abend 233 for an invalid input parameter. In these cases, 
LOGREC entries are not created and retry is not attempted. 
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SYS1.L0GREC ENTRIES PRODUCED FOR SVC DUMP ERRORS 

The best starting place for debugging SVC dump problems is the 
SYS1.L0GREC entries contained in the 4*n-storage SYS1.L0GREC 
buffer or in the SYS1.L0GREC data set/ because a dump of the SVC 
dump problem is generally not available. (SVC dump does not 
take a dump of its own problems.) 

Many SVC dump problems can be debugged from the SYS1.L0GREC 
entries alone. However/ more complex problems may require a 
stand-alone dump that can be taken when a SLIP trap with 
ACTION=WAIT has been encountered. These problems include loops 
and failures to free critical system resources. 

Following is a description of the fixed data entries and the 
variable data entries that SVC dump places in the system 
diagnostic work area (SDWA) for recording on SYS1.L0GREC* 


Fixed Data Entries for Recording on SYS1.L0GREC 


SDWAMODN 

SDWACSCT 

SDWAREXN 

SDWARRL 

SDWASC 


Load module name (generally IGC0005A/ which 
is the SVC 51 load module in SYS1.LPALIB). 

CSECT (microfiche) name in error/ which can 
be any SVC dump module name. 

Name of the CSECT (microfiche) that contains 
the recovery routines that handles the 
error. 

Recovery routine name/ which is given as a 
label. This label can be found in the CSECT 
given by SDWAREXN. 

Phrase that describes the general area of 
SDUMP that experienced the problem. 
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The following table shows the label of the recovery routine* the 
microfiche name of the containing CSECT* and a description of 
the recovery processing. 

Label CSECT Description 

DTESTAE1 IEAVTSDT ESTAE routine for scheduled SVC dumps 

that are executing under the dump task 
(IEAVTSDT) in the requested address 
space. IEAVTSDT also establishes SDESTAEX 
which can percolate to DTESTAE1. 

DTESTAE1 records the problem and does the 
following to clean up: 

1. Frees the RSB. 

2. Page-releases the virtual buffer. 

3. Sets the system dispatchable. 

4. Sets the address space swappable. 

5. Enables for asynchronous interrupts. 

6. Sets the tasks in the address space 
dispatchable. 

7. When dump processing completes* posts 
the SDUMP caller. 

8. When dump processing completes* 
unlocks SDUMP. 

ESTAEXIT IEEMB879 ESTAE routine for the master trace exit 

routine invoked by SVC dump module 
IEAVTSDU. This ESTAE is established by 
IEEMB879. 


SCHFRR IEAVTSDX FRR routine for branch entry to SDUMP. 

SCHFRR covers module IEAVTSDX from entry 
to exit but does not cover any of the 
SRBs. SCHFRR records all errors except 
X 1 2 133* and X v 233 v abends* and does the 
following to clean up: 

1. Frees the RSB. 

2. Frees the system trace buffer if it 
was obtained. 

3. Unlocks SDUMP. 

SDESTAEX IEAVAD00 ESTAE routine for mainline SVC dump 

processing. This ESTAE is established by 
IEAVAD00 and IEAVTSDT. While 
percolating* SDESTAEX records errors in 
SDUMP processing and does the following 
to clean up: 

1. Frees the RSB. 

2. Page-releases the virtual buffer in 
DUMPSRV. 

3. If the dump is finished* calls 
IEAVTSDC. 

If not, calls IEAVTSDE entry IN 
IEAVTSDC. 

4. If the dump is finished* posts 
callers ECB and unlocks SDUMP. 


SDFRRRTN IEAVAD00 FRR routine for mainline SVC dump 

processing. This FRR is established by 
SVC dump modules when a lock is held and 
a retry is needed in the locked state. 
While percolating* SDFRRRTN records 
errors in SDUMP processing and does the 
following to clean up: 

1. Frees the RSB. 

2. If the dump is finished* unlocks the 
SDUMP. 
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Label 

SRBFRR 


SUMFRR 


SRBFRR1 


CSECT Description 

IEEMB880 FRR routine for IEEMB880 which is the SRB 
routine that does data moves for 
IEEMB879. IEEMB879 is the master trace 
exit for SVC dump. This FRR is 
established by IEEMB880. 

1EAVTSSD FRR routine for summary dump processing 
invoked for branch-entered SVC dumps. 

This FRR is established by IEAVTSSD. 
SUMFRR does recording and retries if 
allowed. No cleanup is performed by 
SUMFRR. 


IEAVTSRB FRR routine for the SRBs scheduled to 
post the dump tasks. This routine* or 
SRBFRR2* records the error; SRBFRR1 does 
the following to clean up: 

1. Sets the system dispatchable. 

2. Sets the address space swappable. 

3. Enables for asynchronous interrupts. 

4. Frees the RSB. 

5. Resets the SDUMP caller. 

6. Sets tasks in the address space 
dispatchable. 

7. Frees the copy of the system trace 

tables. 

8. If the SDUMP is completed* posts the 
caller and unlocks SDUMP. 


Variable Data Entries for Recording on SYS1.L0GREC 

The variable data that SVC dump places in the SDMAVRA field of 
the SDMA for recording on SYS1.L0GREC is: 

• The 24-byte recovery routine parameter area if DTESTAE1* 
SDESTAEX* SDFRRRTN* or SUMFRR is the recovery routine name 
in SDNARRL. This area contains bits that indicate the 
resources held* other status bits* the retry address* the 
register update block (RUB) address* and the address of the 
SVC dump data area (ERRSDDAT at X'O'). The contents of the 
parameter area are mapped by the IHASDERR macro. The common 
name of the work area is ERRHORK. 
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The ERRHORK data is mapped as follows: 


Offset 

Length 

Name 

Description 

0(0) 

24 

ERRNORK 

Mapping for ESTAE/FRR work 
area, used by modules called 
by IEAVAD00 and IEAVTSDT 

0(0) 

4(4) 

4 

ERRSDDAT 

ERRRTDAT 

Address of SDDAT for reg 7 

Retry data 

4(4) 

4 

ERRRETRY 

Retry address used by the 
error recovery routine. If 
zero, then percolation is 
requested. 

8(8) 

4 

ERRRUBAD 

Address of the RUB used to 
reload registers for retry. 

12(C) 

4 

X 

Reserved 

16(10) 

1 

ERRFLGS1 

First flag byte: 

1.. . 

# # § f 

ERRSDFIX 

IEAVTSDG is page fixed 

.1.. 

• • • • 

ERRPGSDL 

IEAVTSDL is page fixed 

. .1. 

• • • • 

ERRSSEFX 

IEAVTSSE is page fixed 

.. .1 

• • • • 

ERRVSMFX 

IEAVTVSM is page fixed 

• • • • 

1... 

ERRVSMTB 

VSMLIST is page fixed 

• # • • 

.1.. 

ERRSDBIT 

1 = SVC DUMP is serialized 
(RTCTSDPL) 

• • • • 

. .1. 

ERRBFBIT 

1 s 4K buffer is serialized 
(CVTSDBF) 

t • • • 

.. .1 

X 

Reserved 

17 (11) 

1 

ERRFLGS2 

Second flag byte: 

1... 

• • « • 

ERRLLOCK 

Local lock is held 

.1.. 

• • » • 

ERRSLOCK 

SALLOC lock is held 

. .1. 

• • • • 

ERRCMSLK 

CMS lock is held 

. . .1 

• • • • 

ERRDLOCK 

Dispatcher lock is held 

• • • • 

1.. . 

ERRCLOCK 

CPU lock is held 

• • • 1 

.1.. 

ERRVPAGE 

VSM page lock is held 

• • • • 

. .1. 

ERRVFIX 

VSM fix lock is held 

• t * • 

. . .1 

ERRSMSER 

RSM serialization held 

18(12) 

1 

ERRFLGS3 

Third flag byte: 

1... 

• • • • 

ERRFRR 

FRR protection is active 

.1.. 

• • • • 

ERRESTAE 

ESTAE protection is active 

. .1. 

.... 

ERRSYSMD 

1 = SYSMDUMP recovery 0 = 

SDUMP recovery 

...1 

.... 

ERRINIO 

Error during 1/0, no retry 

• • • • 

1.. . 

ERRENDMP 

Terminating error indicator 

• • • • 

.1.. 

ERRSDENQ 

ENQ performed on SDUMP 
resource 

• • • » 

. .1. 

ERRTRMNT 

All dump tasks should DEQ and 
quit because of terminating 
error 

• • • • 

.. .1 

ERRENDSW 

Switch to end-of-loop 
processing 

19(13) 

1 

ERRFLGS4 

Fourth flag byte: 

1... 

• # • • 

ERRSRBSD 

SRB being scheduled 

.1... 

• • • • 

ERRCSDT 

IEAVTSDT called this module 

. .1. 

• • • t 

ERRCUDMP 

Indicate this is current active dump 

. . .1 

• • • • 

ERRNORCD 

Indicate recording not needed 

» • * » 

1. .. 

ERRCDOUT 

At least 1 RCD in dump data set 

• • » 1 

.1.. 

ERRTCBND 

TCBs in address space not dispatched 

• • t • 

. .1. 

ERRGTFGO 

Hook macro issued for GTF 

• • • • 

...1 

ERRSSEXM 

Module IEAVTSSE changed XM 
modes 

20(14) 

1 

ERRFLGS5 

Fifth flag byte: 

1... 

• • • • 

ERRSDCEN 

SDC has been entered and 
should not attempt cleanup 
again 

• Ill 

1111 

X 

Reserved 

21(15) 

1 

ERRSAVE 

General save space 

22(16) 

2 

X 

Reserved 
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• For ESTAEXIT (IEEMB879) and SRBFRR CIEEMB880), the variable 
data consists of as much of the SVC dump exit parameter list 
(SDEXPARM) as will fit in the SDHAVRA. 

The SDEXPARM data is mapped (by the IHASDEXP macro) as 
follows: 


Offset Length Name Description 


0(0) 

4 

SDEXECB 

ECB used to synchronize SVC dump 
processing. 

9(4) 

4 

SDEXASCB 

ASCB address used to post the ECB. 

8(8) 

2 

SDEXNAID 

ASID used to post the ECB. 

10(A) 

2 

- 

Reserved. 

12(C) 

4 

SDEXBFAD 

Buffer address for the data moved 
by the exit. 

16(10) 

4 

SDEXBFLN 

Length of the data buffer 

20(14) 

4 

SDEXORAD 

Address of the output routine used 
to process the buffer. 

24(18) 


SDEXKEYS 

Two one-byte keys — for first and 
second 2K of storage in the buffer. 

26(1A) 

2 

SDEXASID 

ASID of the data that was last 
moved to the buffer. 

28(10 

4 

SDEXNDAD 

Address of the next data to move 
to the buffer. 

32(20) 

5 

SDEXCDAD 

From address of the data that was 
last moved to the buffer. 

36(24) 

4 

SDEXBTTA 

Start address of the master trace 
table (if the master trace exit is 
executing. 

40(28) 

4 

SDEXTTLN 

Length of the master trace table 
(if the master trace exit is 
executing). 

44(20 

72 

SDEXSAVE 

Save area for exit use. 


The following routines enter the data indicated into the 
variable recording area in key/data format: 


Label CSECT Description 

DTESTAE1 IEAVTSDT • 6-word ESTAE parameter area (see 

ERRWORK). 

• The data from RTCT: RTCCSDI, 

RTCTSDF, and RTCTSDF3. 

See RTCT (mapping macro) for details. 

• DSTAT/DAE dump status flags 
mapped by ADYDSTAT. 

SCHFRR IEAVTSDX • 6-word FRR parameter area. 

• SDRSN-first word of SDRSN from 
RTSDSRSN. 

See SDRSN (mapping macro IHASDRSN) 
for details. 

• DSTAT/DAE dump status flags 
mapped by ADYDSTAT. 

• Current TCB address (PSATOLD). 

• IHASDUMP/parameter list address from 
RTCTSDPL parameter list. 

• IHARTSD/RTSD address from RTCTRTSD. 

• RTSDXMST/contents of RTSDXMST 
(caller's control registers). 

• RTSDXPSW contents of 
RTSDXPSW/caller's PSW. 

• ASCB address of address space 
whose CML is held/ from field 
RTSDCMLA. 

• RTSDCMSV/ save area for 
SVC dump CMSETs. 
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SUMFRR IEAVTSSD 
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Description 

• 6-word ESTAE work area (see ERRNORK). 

• RTCTSDF3/RTCT ASID array (16 one-word 
entries). 

• SDRSN—contents of SDNSDRSN mapped by 
IHASDRSN. 

• DSTAT/DAE dump status flags 
mapped by ADYDSTAT. 

• IHASD’JMP/parameter list address 
(SDNSDPL) parameter list. 

• 6-word ESTAE work area (see ERRNORK). 

• RTCTSDF3/RTCT ASID array (16 one-word 
entries). 

• SDRSN—contents of SDNSDRSN mapped by 
IHASDRSN. 

• DSTAT/DAE dumps status flags mapped by 
ADYDSTAT. 

• IHASDUMP/parameter list address 
(SDMSDPD/parameter list. 

• 6-word FRR area mapped by IHASUMFR. 

• SDRSN—1st word of SDRSN from RTSDSRSN. 

• Current TCB address (PSATOLD). 

• Home ASID (ASCBASID). 

• SMWKRFAD/88 characters starting at 
SMNKRFAD. 

See IHASMNK for details of the data. 

• SMWKNFRQ/76 characters starting at 
SMMKNFRQ. 

See IHASMNK for details of the data. 

• 6-word parameter area. 

• RTCTSDF3/RTCT ASID array (16 one- 
word entries). 

• SDRSN/ contents of SDNSDRSN mapped by 
IHASDRSN. 

• DSTAT/DAE dumps status flags mapped by 
ADYDSTAT. 

• IHASDUMP/parameter list address 
parameter list. 


CONTROL BLOCKS USED TO DEBUG SVC DUMP ERRORS 


The following control blocks contain key information that can be 
used to debug problems in SVC dump routines. 


• Address space control block (ASCB) 

• DUMPSRV control block (DSVCB) 

• Recovery termination control table (RTCT) 

• RTCT extension for SDUMP (RTSD) 

• SVC dump DIE control block (SDDIE) 

• SVC dump work area (SDHORK) 

• Summary dump work area (SMNK) 

• SVC dump data areas (SDDAT) 


Address Space Control Block (ASCB) 


The ASCB contains the address of the TCB for the SVC dump task 
(IEAVTSDT) in the ASCBDUMP field (at offset X'60*). In this 
TCB, the TCBEXSVC bit (low-order bit at X'CC') is set on while 
the SVC dump task is executing. The ASCB is mapped by the 
IHAASCB macro. 
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DUMPSRV Control Block (DSVCB) 

The DSVCB is pointed to by RTCTDSV CX'2C V ) and is mapped by 
IHADSVCB. The DSVCB controls functions in the DUMPSRV address 
space. It is partitioned into sections which control separate 
functions. There is a section for address space control, dump 
data set control, and post dump exit processing. 


Recovery Termination Control Table CRTCT) 

The RTCT is pointed to by the CVTRTMCT field (at X'23C*) in the 
CVT. It contains SVC dump information including status bits, 
and an array that contains information for the address spaces to 
be dumped. The RTCT is mapped by the IHARTCT macro. 

The RTCT has a pointer (RTCTSDDS X'24') to the dump data set 
queue (SDDSQ). Each element in the queue is mapped by the 
SDDSQ, which is in mapping macro IHASDDSQ. See this mapping for 
any problems with selecting dump data sets or in using the 
DUMPDS command which modifies this queue. 


RTCT Extension for SDUMP C RTSD) 

The RTSD is pointed to by RTCTRTSD (X , 16C I ) and is mapped by 
IHARTSD. The RTSD contains working storage and flags for SDUMP 
and an area which is used to save a copy of most of the caller's 
parameters. The caller's parameter list, storage lists, dump 
header, and other parameters are saved to allow the caller to 
release storage (using IEAV6M00) which may have been obtained to 
call SDUMP. 


SVC Dump DIE Control Block (SDDIE) 

The SDDIE contains all the storage used by the SVC dump timer 
DIE routine, IEAVTSDB. The SDDIE protects critical SVC dump 
resources. There are two SDDIE control blocks in the system. 
Both SDDIE control blocks are mapped by IHASDDIE. The SDDIE 
that protects the SVC dump real storage buffer is pointed to by 
RTCTDIRS (X'60') in the RTCT. The SDDIE that protects the 
system/task non-dispatchability is pointed to by RTCTDIND 
(X'50') in the RTCT. This SDDIE also protects the stopped unit 
of work during suspend summary dump processing. 


SVC Dump Work Area (SDWORK) 

The SDWORK is pointed to by the RTCTSDWK field (at X'DC') in the 
RTCT. It contains most of the reentrant storage used by SVC 
dump, including pointers to the I/O buffers and pointers that 
contains the 4104-byte SVC dump records before they are written 
to the dump data set. The SDWORK work area is mapped by the 
IHASDWRK macro. 


Summary Dump Work Area (SMWK) 

The SMWK is pointed to by the RTCTSDSW field (at X»B4') in the 
RTCT and contains fields used when a summary SVC dump was 
requested or defaulted (via the SUMDUMP option on the SDUMP 
macro). It includes counter fields that show how many real 
frames are used for the real storage buffer that holds the 
summary dump created for branch-entry callers of SVC dump. The 
count of real frames held (field SMWKFRHD at X'9A») is zeroed 
after the summary dump is written to the dump data set and the 
frames returned to RSM. The SMWK work area is mapped by the 
IHASMWK macro. 
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The SDDAT is pointed to by the RTCTSDAT field at (X’64 1 ) in the 
RTCT. It contains pointers to all SVC dump primary data areas. 
This includes pointers to storage for dump SRBs, parameter lists 
for external services and working storage for SVC dump modules. 
The SDDAT data area is mapped by the IHASDDAT macro. 


RESOURCE CLEANUP FOR SVC DUMP 




At the end of an SVC dump/ module IEAVTSDC (SDUMP cleanup 
routine) is given control and performs the following operations 
when necessary: 

1. Sets the system dispatchable. 

2. Sets the address space swappable. 

3. Sets the tasks in the address space dispatchable. 

4. Page-frees any modules or control blocks which were fixed by 
SDUMP. 

5. Frees the copy of the saved system trace table. 

6. Writes an end of file on the dump data set. 

7. Issues message IEA911E for complete or partial dumps. 

8. Issues or deletes message IEA994E or IEA994A for all dump 
data sets that are full. 

9. Initiates post exit processing. 

SVC dump also has a termination resource manager (IEAVTSDR) 
pointed to by CVTSDRM (X'21C*). IEAVTSDR receives control for 
all task and memory terminations. IEAVTSDR examines a resource 
manager parameter list (RMPL) to determine if any processing is 
required. IEAVTSDR handles the following situations: 

• Memory terminations for address spaces involved in an SVC 
dump. 

• Task terminations for tasks involved in an SVC dump. 

• Memory termination of the DUMPSRV address space. 

IEAVTSDR performs the following functions when necessary: 

1. Frees the real storage buffer. 

2. Sets the system dispatchable. 

3. Sets the tasks in the address space dispatchable. 

4. Frees the copied system trace table. 

5. Resets the stopped caller of SDUMP. 

6. Page-releases the virtual storage buffer. 

7. Posts the SVC dump caller. 

8. Unlocks SVC dump by zeroing the high-order bit of CVTSDBF 
(in the CVT) and zeroing the RTCTSDPL (in the RTCT). 

9. Cleans up the DUMPSRV address space: 

• Frees storage on the post exit processing queue. 

• Removes entries from the SDDSQ that were added with 
DUMPDS. 

• Restarts the DUMPSRV address space. 
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SVC dump also has a timer DIE processor (IEAVTSDB), which is 
pointed to by RTCTSOBB (X , 64 f ) in the RTCT. IEAVTSDB protects 
the following critical SVC dump resources: 

• The real storage buffer 

• System non-dispatchability 

• Task non-dispatchability 

• The stopped unit of work during suspend summary dump 
processing 

IEAVTSDB performs the following operations when it detects that 
SVC dump processing has halted processing or has failed: 

• Returns held real storage buffer frames to the system. 

• Resets the system dispatchability. 

• Resets the tasks of the address spaces (involved in the SVC 
Dump) dispatchability. 

• Resets the stopped SVC dump caller v s unit of work during 
suspend summary dump processing. 
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PROCESS FLOW 


The figures in this section provide a functional overview for 
the following DMP services« 

• Abnormal end-of-task 

• ABEND/SNAP dump processing 

• SVC dump overview 

• Formatted dump module flow 

• Summary SVC dump (SUMDUMP) formatter for the AMDPRDMP 
service aid 

• Synchronous unformatted dump module flow 

• Scheduled unformatted dump module flow 

• Master trace dump exit processing 

• RTM services module flow 

• Data management control block formatter 

• I0S control block formatter 
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ABEND 


Entered by 
SVC 13 


TCB 

(in RTM2) TCB 



1 


IEAVTRT2 


—— ^ 



n 


— 


• Obtain, initialize, and queue 

v 



1—1 


TCB 

I (in RTM2) 


Abnormal Termination 
This figure shows the logic flow during 
abnormal termination of a non*critical 
nature. If the error is not recoverable 
at a particular task level, that task and 
its subtasks are removed. If the scope 
of the ABENO is step, then the 
entire job step is removed. Optionally, 
serviceability information (dumps and 
software error records! is supplied to 
the user. 


the RTM2 work area and 
RTM2 SOW A. 

# Save a copy of the trace table. 

IEAVTRTC~~| ~ ^ 

• Validity check and process 
the dump options. 


Exit 

requested 


IEAVTRTC j 

• Determine the scope of the 
ABEND. 

• Purge the resources & halt I/O. 


IEAVTRTC 

• Indicate ABEND in progress. 


(Recovery processing 
for falling task) 

} IEAVTAS1 

) • Select an exit (SCB). 

• Obtain and initialize the user's 
SDWA. 

| • Perform the I/O requests and 
block asynchronous exits, 
if requested. 

• Issue a SYNCH macro ^ 

► to EXIT. ♦J L 


SYNCH 




IEAVTAS2 | ^ 

• Track the user's SDWA. 

• Record, if requested. 

• Save the dump options. 

IEAVTAS3 

• Free the user's SDWA. 

IEAVTABP 1 

• Start ABDUMP processing. 


User exit 

i • Diagnose 
the error. 

> 

• Select the 
options. 


Recorder 


Symptom 
t SYMPTOM 

S YSABEN D/SY SDUMP 
► SNAP 

SYSMDUMP 
rf SDUMP I 


Figure 1 (Part 1 of 2). Abnormal End-of-Task 
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IEAVTRTC | 

• Indicate ABEND In 
progress. 


RTM2WA 


(Term exit processing 
for subtasks of failing task) 

t EA VT AS 1 ~| 

• Select a TERM exit. 

• Obtain and initialize the 
user's SDWA. 


SYNCH 


User exit 

• Diagnose 
the error. 


SCBTERMI 


3 * TCB 


Control Is 
returned from 
IEAVTAS1 
B^ (S tacking) 

itAvimo 


Branch to thei 
dispatcher ^ 


IEAVTRT2 


•Terminate the SMC subtasks 
with an abend code of X'lQO'. 

• Wait for the subtasks in RTM2 
to complete. 

• Set the subtasks non> 
dispatchable. 

• Purge the resources. 

IEAVTRT2 I 


Abnormal I IEAVTRTE | 

• Free the copied trace table. 

I • Free the RTM2 work areas 
I and SDWA. 


EXIT 
► Prolog 
IIEAVEEXP) 
normal exit 


IEAVTAS2 | 

• Track the user's SDWA. 

• Record, if requested. 

• Save the dump options. 


IEAVTAS3 | 

• Free the SDWA. 


IEAVTSKT I 

• Find and detach the 
deepest subtask. 

• Purge the resources via the, 
resource managers. 

• Update the RB queue for exit. 


• Select the 
options. 


Recorder 


• Clear the TCB flags. 


Figure 1 (Part 2 of 2). Abnormal End-of-Task 
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(See Part 2 of 3) 


Note: SDDAT the SDUMP data area contains pointers to the following fields: 


• ID 

• 

SDTAB 

• SDPL 

• 

SDEXP 

• SDWRK 

• 

SMWK 

• SDMOD 

• 

ERRWK 

• SDCON 

• 

TRSN 

• RNGTB 

• 

TRCT 

• RNGTE 

• 

LVLWK 

• OBPFX 

• 

DSPD 

• OBUFF 

• 

MDSN 

• EXBUF 

• 

MDECB 

• CPYHD 

• 

MSYMP 


This figure provides an overview of all data areas releated to ABEND/SNAP dumps, the sources from 
which the dump options are obtained, the key modules involved and the 

complete scheme of data flow. It ties together the function of system initialization requestor's dump 
options and operator intervention. 


Figure 2 (Part 1 of 3). 


ABEND/SNAP Dump Processing 
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Figure 2 (Part 2 of 3). ABEND/SNAP Dump Processing 
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Dump options for ABEND (fumps are determined from: 

1) The options specified on the ABEND. CALLRTM or SETRP macro; 

2) The options specified in SYS1.PARMLIB members IEAABDOO (SYSABEND 
options). IEADMPOO (SYSUDUMP options), and IEADMROO (SYSMDUMP 
options). 

3) Options specified on the CHNGDUMP command. 

When dump options are requested using more than one of the above, the order of 
selection is as follows: 

1. CHNGDUMP options with OVER requests completely override any other request. 

2. CHNGDUMP options with ADD requested are merged with options specified on 
ABEND. CALLRTM. or SETRP macros and this result is merged with options 
specified in IEAABDOO. IEADMPOO. or IEADMROO. 

3. Lacking CHNGDUMP options, the options specified on the ABEND. CALLRTM or 
SETRP macros are merged with the options in IEAABDOO. IEADMPOO. or 
IEADMROO. 

A. If no options were specified on the ABEND. CALLRTM or SETRP macros, 
the options specified in IEAABDOO, IEADMPOO of IEADMROO are used. 

If no options are specified via CHNGDUMP, ABEND, CALLRTM, SETRP, 
IEAABDOO, IEADMROO, or IEADMPOO, and symptom dump is not 
suppressed, a symptom dump is produced. If no option's are specified 
and symptom dump is suppressed, no dump is taken. 

For ABDUMPS the requestor (via ABEND, CALLRTM, and SETRP) and 
installation (via SYS1.PARMLIB members IEAABDOO. IEADMPOO, and IEADMROO) 
are given the ability to tailor dumps to the needs of the installation and the individual 
maintenance requirements of each error type. In addition, the CHNGDUMP command 
provides a means of temporarily overriding options specified by the requestor and/or 
installation. 


Figure 2 (Part 3 of 3). 
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from the requestor's) is explained 
by the control flow and data flow 
shown here. 



Figure 3 (Part 1 of 3). SVC Dump Overview 
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IEAVTSDI obtains storage for and initializes the following 
SVC Dump and dump analysis and elimination (DAE) 
control blocks: 

RTSD — RTCT extension for SVC Dumps 
SMWK - Summary dump work area 

SDWORK — SVC Dump work area 
SDDAT - SVC Dump data area 
SDMOD — SVC Dump module pointers 
SDCON - SVC Dump constants 
ERRWORK - SVC Dump error work area 
SDTAB — SVC Dump work table for VSM interface 

SDEXP - SVC Dump exit parameter area 

SDDIE — SVC Dump DIE control block for the real 
storage buffer 

SDDIE — SVC Dump DIE control block for system 
non-dispatchabi I i ty 

DSVCB — DUMPSRV control block 

DSCA — DAE communication area 

DFLM — DAE default options 

DSPD — DAE pre-dump/post-dump parameter list 

AMDDATA — Dump header record 

IEAVTSDI loads and page-fixes SVC Dump and DAE modules 
which remain fixed. The address of these page-fixed modules 
are stored in the CVT, RTSD, RTCT, SDMOD, and DSCA. 

The presence of the ASID, ASIDLST, LISTA, SUBPLST, or 
TYPE-XMEM/XMEME keywords indicates a request to dump 
storage in specific address spaces other then the caller's._ 


© 


© 

© 

© 


(continued) 

IEAVAD00 calls the nucleus routine (IEAVTSDX) to 
schedule global SRB routines to start the dump. An SRB 
routine posts the resident dump task (IEAVTSDT) in each of 
these address spaces. The dump task invokes the necessary 
SVC Dump service modules to dump the required storage in 
the requested address space. The first dump task to receive 
control schedules the SRBs to all other requested address 
spaces. When dumping is complete in all the requested 
address spaces, IEAVTSDT posts the ECB specified by the 
caller. The dump task then issues the WAIT macro and 
waits for the next dump request. 

If the caller did not specify the ASID, ASIDLST, LISTA, 
SUBPLST, or TYPE-XMEM/XMEME keywords, SVC Dump 
runs under the TCB of the caller. No scheduling of the 
dump is performed. 

The SVC Dump task IEAVTSDT in each address space is 
attached by the RCT, except in the master address space, 
where it is attached by IEAVTMSI (master scheduler RTM 
initialization routine). 

If CHNGDUMP dump options exist, they override, or 
are added to the requested options. 


Figure 3 (Part 3 of 3). SVC Dump Overview 
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Figure 5. Summary SVC Dump (SUMDUMP) Formatter for the AMDPRDMP Service Aid 
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Figure 10. Data Management Control Block Formatter 
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Figure 11. IOS Control Block Formatter 
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METHOD OF OPERATION 


This section contains logic diagrams for the modules in this 
component. 

The modules are in alphabetic order; and the diagrams use either 
hipo format or prologue format. 

The following figure shows the symbols used in hipo format logic 
diagrams. The relative size and the order of fields in control 
block illustrations do not always represent the actual size and 
format of the control block. 



-> 


t 


v—► 


Key to Symbols Used In Method-of-Operatlon Diagrams 


Primary processing - indicates major funtional flow. 


Secondary processing - indicates functional flow 
within a diagram. 


Data movement, modification, or use. 


Data reference -- indicates .the testing or reading 
of o data are cf to determine the 
course of subsequent processing. 


Pointer -- indicates that a data area contains the 
address of another data area. 


Indirect pointer -- indicates intermediate pointers 
have been omitted. 


Connector - indicates that a diagram is 

continued on the next page. 


Figure 12. 
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The Prolog format diagrams contain detailed information that is 
broken down into three different headings. The three headings 
and the topics they document are: 

Module Description, which includes: 

• Descriptive name 

• Function (of the entire module) 

• Entry point names, which includes: 

— Purpose (of the entry point) 

— Linkage 
— Callers 
— Input 
— Output 
— Exit normal 
— Exit error, if any 

• External references, which includes: 

— Routines 

— Data areas, if any 

— Control blocks 

• Tables 

• Serialization 


Note: Brief DMP module descriptions are also included in 
MVS/Extended Architecture System Logic Library: Module 
Descriptions # which contains module descriptions for all the 
MVS/Extended Architecture components described in the System 
Logic Library. 


Module Operation, which includes: 


• Operation, which explains how the module performs its 
function. 

• Recovery operation, which explains how the module 
performs any recovery. 


Diagnostic aids, which provide information useful for 
debugging program problems; this includes: 


• Entry point names 

• Messages 

• Abend codes 

• Wait state codes 

• Return codes for each entry point. Within each entry 
point, return codes might be further categorized by 
exit-normal and exit-error. 

• Entry register contents for each entry point 

• Exit register contents for each entry point 


Logic Diagram, which illustrates the processing of the 
module, the input it uses, the output it produces, and the 
flow of control. Some modules do not have a logic diagram 
because the processing is sufficiently explained in the 
module description, the module operation, and the diagnostic 
aids sections. Figure 13 on page DMP-51 illustrates the 
graphic symbols and format used in the logic diagrams. 


DMP-50 MVS/XA SLL: Dumping Ser 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 



"Restricted Materials of IBM” 
Licensed Materials - Property of IBM 


L06ICKEY - Key to the Logic Diagrams 


STEP 01 


Callers 1“"“““———————————— 

I - 1 This paragraph describes what this module 

I u \ does. The same text appears under the 
I > FUNCTION heading on the Module Description 
1 / page. 

LOGICKEY 


01 Numbered steps describe the 
— processing at a high level. 

A. Lettered steps describe the processing 
at a lower level. 


SPQA 

[sPQAADQE SPQAEDQeI 



1021 Input and output fields. 

The control block acronym or data area name 
appears above the input and output boxes> 
and the field names appear within the 
boxes. A dotted arrow means the data is 
referenced* a solid arrow means the data is 
modified. 


03 External call graphic 
— 1 passing the parameter, TROB. 



04 Internal call graphic (at 
— 1 the step indicated! passing 
two parameters. 



SUBROUTN; 12 


EFMSG1, TFWAPMSG 


05 Macro instruction graphic 
— 1 with these keywords, 

parameters, and options. 


(EAERIMWT> RCO) ASCB(TOBAASCB->ASCB) 
ERRET(CVTBRET) 


TOBAASCB 


\SPQE 

/l- 

SPQENEXT 

SPQESPQA 

SPQETCB 



06 Internal branch to the label 
— 1 and step indicated. 


>BRLABEL: 08 


Figure 13. Key to the Logic Diagrams (Part 1 of 2) 
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L06ZCKEY - Key to the Logic Diagrams 


STEP 07 


-K 

08 > 

- 1 / 

BRLABEL 


Callers 


PARAMETERS 

TROB THISLINEr-J 
MAXLINES ETPBOPTSI L 


TTE 


TTEMB21 



DOILABEL 
-> 


071 SVC graphic. 

<—>r 


SVC TSOTEST 


08 


Step 06 branches here. A 
program call (PC) graphic 
shows an exit. 


PC 


09 Secondary entry point. 


This paragraph describes the function of 
this entry point. Four parameters (to the 
left) are passed an input. 


10 


This is the beginning of an 
iterative DO group. 


A. Iterate graphic of the DO 

instruction to the specified step 
number. 


B. Leave graphic of the DO instruction 
to the specified step number. 


11 External return graphic# to 
— 1 the calling routine. 


10 




-Is 

12 > 

—- 1 / 

SUBROUTN 


1- 

12 

This is an internal 
subroutine. 

This paragraph describes the function 
of this subroutine. 



13 


Internal return graphic* to 
a step within this module. 


91 


Figure 13. Key to the Logic Diagrams (Part 2 of 2) 
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IEAVAD00 - SVC 51 Overview (Part 2 of 2) 

Extended Description Module Label Extended Description Module 


An SVC 51 instruction provides linkage to both the SNAP 
function and to the SVCDUMP function. Both functions 
require that register 1 point to a parameter list. The SVC 
FLIH enters SVC51 processing holding the local lock in 31 
bit addressing mode. The distinction between a SNAP and 
an SVCDUMP parameter list is in byte 1 of the first word: 
if X'80', the parameter list is for SVCDUMP; any other 
value in byte 1 indicates that the parameter list is for SNAP. 

If SVC 51 processing finds a SNAP parameter list it calls 
SNAP processing. Otherwise, it calls SVCDUMP processing. 

1 SVC 51 identified a SNAP parameter list. SVC 51 IEAVADOO SDTOP 

produces a formatted, synchronous dump of the 

requested storage area. The M.O. diagram Snap Dump Pro¬ 
cessing (IEAVAD01) describes this process in detail. IEAVAD01 

2 SVC 51 identified an SVC dump request. Callers of IEAVADOO SDTOP 

SVC dump must be authorized by APF and have a 

control program key. SVC 51 processing abnormally 
terminates unauthorized callers with a completion code 
of X'133'. 

SVC dump provides an unformatted storage dump of 
virtual storage areas for one to 15 address spaces. Two 
separate processes are used to provide these dumps. 

Synchronous dump processing (also called SVC dump 
processing) provides a synchronous, unformatted dump 
of the caller's address space. 

The options specified in the SDUMP parameter 
list determine whether a synchronous or scheduled 
dump is taken. The determining options are: 

ASID - A single ASID specifying the 

address space to dump. 


ASIDLST - A list of ASIDs to be dumped. 

LISTA • A list of ASIDs and related 

storage to be dumped. 

TYPE°XMEM - Dump the home, primary, and . 

secondary ASIDs related to the 
caller at the time SDUMP is 
entered. 

TYPE°XMEME* Dump the home, primary, and 
secondary ASIDs related to the 
caller at the time of error. 

SUBPLST - A list of ASIDs and related 
subpools to be dumped. If 
the only ASID in this list is 
the caller's, this option will not 
force a scheduled dump. 

a. If none of the above options are specified, a synchronous IEAVADOO 
dump of the caller's address space is taken. The M.O. 

diagram SVC dump processing (IEAVADOO) explains the 
synchronous dump processing section of SVC dump. A 
synchronous dump is always taken when SVC 51 is 
issued by ABDUMP to process SYSMDUMPs. 

b. If any of the above options are specified, an asynchronous IEAVTSGL 
dump of all requested address spaces is taken. Issuing 

an SVC for an asynchronous dump request results in a 
call to the schedule dump routine (IEAVTSDX) through 
interface with module IEAVTSGL. Asynchronous dump 
requests are also made by branching directly to the 
schedule dump processing routine using the BRANCH= 

YES keyword on the SDUMP macro (SVC dump branch 
entry). Interface to IEAVTSDX is again through the 
module IEAVTSGL. 

The M.O. diagram Schedule Dump Processing (IEAVTSDX) 

describes this process in detail. 


Label 


SDTOP 
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Label 


IEAVADGO - SVC Dump Processing (Part 2 of 12) 

Extended Description Module 

SVC dump processing creates a synchronous unformatted 
dump of virtual storage and writes It on a data set. SVC 
dump receives control from SVC 61 when the parameter 
list addressed in register 1 indicates an unformatted dump. 

1 SVC dump uses TESTAUTH to verify the authorization IEAVADOO 
of the caller. Callers of SVC dump must be APF 

authorized and running in keys 0-7. IEAVADOO abends callers 
who are not authorized to use SVC dump with a system 
code of X'133\ 

2 If SVC 51 requests a schedule dump, IEAVADOO 
invokes module IEAVTSDX through the addressing 

mode interface module IEAVTSGL. IEAVADOO 
schedules a dump for the following: 

a A multiple address space dump 

a A dump of an address space other than the current 
address space 

a A request for USTA storage ranges 
a A request for TYPE«XMEM or TYPE-XMEME 

a A request for SUBPLST with an ASID other than 
the current ASID 

Upon return from IEAVTSDX, SVC dump returns control 
to the caller with a return code stating whether or not the 
dump is scheduled. 

3 IEAVADOO uses SETFRR to establish a functional IEAVADOO 

recovery routine (FRR) exit. This exit provides 

recovery for SVC dump processing, which runs disabled 
or locked. 


IEAVADOO 

IEAVTSDX 

IEAVTSGL 


TOPSEG 


TOPSEG 


TOPSEG 

SDFRRRTN 
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Label 


Extended Description 


Module 


Label 


IEAVAD00 — SVC Dump Processing (Part 4 of 12) 

Extended Description Module 


4 IEAVADOO serializes SDUMP to prevent the system 
from trying to take concurrent SDUMPs. IE A VADOO 

fills in the RTCTSDPL work with the address of the SDUMP 
parameter list and turns on the high-order bit of the CVTSDBF 
work. If either of these two serialization procedures fails, 
the dump is cancelled due to an SDUMP already in progress. 
For SYSMDUMP requests, I EA VADOO does not check 
if SDUMP is already in progress. Multiple SYSMDUMPs 
are allowed because the SYSMDUMP process does not use 
or modify any SDUMP control blocks. 

5 I EA VADOO examines the RTCT for the CHNGDUMP 
overriding parameter which specifies that no SVC dumps 

are to be taken. I EA VADOO checks to verify that at least 
one dump data set has been defined, and checks system 
control blocks to make sure this dump is not being 
suppressed by the SLIP NODUMP process. If no dump can 
be taken, the caller is given a return code of 8 in register 
15 and a reason code is stored in the SDWA. 

Note: For SYSMDUMP requests. SNAP/ABDUMP processing 
has already examined and merged the CHNGDUMP options. 

6 IE A VADOO checks the validity of the parameter list 
and areas pointed to by the parameter list. It calls 

the SDUMP parameter list analysis routine (IEAVTSPR) 
to perform the following functions in the COPYPARM 
subroutine: 


If the caller supplied a DCB, I EA VADOO calls the SDUMP 
parameter list analysis routine (IEAVTSPR subroutine 
VALDCB) to validate the user's DCB. The DCB must 
represent an open data set on tape or DASD. If the 
caller specified a DASD data set, the data set must be 
on a supported device with a track size of at least 4104 
bytes. 

If the caller supplied a subpool list (SUBPLST keyword 
specified), IEAVADOO calls the SDUMP parameter list 
analysis routine (IEAVTSPR subroutine SDSUBPL) to 
sort the list into global and local subpools. The sorted 
lists are put in the correct format for later use by VSM, 
and stored in the RTSD. For SYSMDUMP requests, 
subpools are processed in a similar fashion and stored 
into the work area passed by ABDUMP as part of the 
SYSMDUMP interface. 

Callers with SDUMP parameter list errors are given 
ABEND X'233\ IEAVAD00 returns a reason code in 
register 15, which describes the parameter in error. 

See Message Library: System Codes for a list of reason 
codes. 


• Clear the parameter area of the RTSD 

• Copy the SDUMP parameter list to the RTSD 

• Copy the header to the RTSD 

• Copy the user's storage list to the RTSD if it is 
less than 484 bytes in length 

• Merge the CHNGDUMP options with the options 
requested in the SDUMP parameter list according 
to the CHNGDUMP mode 
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IEAVADOO - SVC Dump Processing (Part 6 of 12) 

Extended Description Module 

7 IEAVADOO initializes the pre-dump parameter list 
(DSPD). IEAVADOO passes the DSPD to ADYPRED, 
the DAE pre-dump processor. ADYPRED determines if this 
dump should be suppressed and builds the DAE portion of 
the dump header record. When ADYPRED returns control, 

IEAVADOO checks the return code in register 15 to 
determine if the dump should be suppressed. 

g If the dump should be suppressed, IEAVADOO saves the 
dump suppression status flags and the dump suppression 
reason code (X'OB' in SDWASDRC) in the caller's SDWA. 

IEAVADOO then calls IEAVTSD1 to begin post-dump exit 
processing. IEAVTSD1 obtains storage and copies the dump 
header record into this storage. IEAVTSD1 posts 
IEAVTDSV and passes a copy of the dump header record. 

IEAVTDSV begins post-dump exit processing. IEAVTSD1 
then returns to IEAVADOO. IEAVADOO unlocks SVC dump 
and sets a no dump return code (X'08' for an SVC dump, 

X'OC' for a SYSMDUMP) in register 15. IEAVADOO returns 
to the caller. 

If the dump is to be taken, processing continues with step 9. 


Label 
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IEAVADOO - SVC Dump Processing (Part 7 of 12) 


Input 


Process 


Output 
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IEAVAD00 - SVC Dump Processing (Part 8 of 12) 

Module 


g If the QUIESCE=YES and CSA or SQA operands were 
requested, SVC Dump informs the system resource 
manager (SRM) not to swap the current address space and 
branch enters the STATUS routine to set the system non- 
dispatchable. IEAVAD00 then calls IEAVTSDB to 
establish the system non-dispatchability timer DIE to 
protect the system and tasks of this address space from 
being left set non-dispatchable due to an unrecoverable 
error in SVC Dump. The STATUS routine is also branch 
entered to set all of the tasks in the address space, except 
the region control task, communications tasks, and the 
current task, non-dispatchable. If GTF is active and the 
TRT option was requested, GTF is invoked to save the 
current GTF buffers for the dump. 

Note: GTF buffers are not dumped for SYSMDUMPs. An 
ESTAE exit is initialized to provide recovery for SVC dump 
processing, which runs unlocked. The current FRR entry is 
deleted and the local lock released. If an RTM2 trace table 
is not available, the SNAPTRC macro is issued. This causes 
the system trace routine (IEAVTRST) to save a copy of the 
system trace tables in a buffer that resides in private storage 
in the trace address space. 
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IEAVAD00 — SVC Dump Processing (Part 10 of 12) 


Extended Description Module Label 

10 SVC dump chooses an available dump data set. II all IEAVTSDH SDHDR 
dump data sets are full, IEAVADQ0 sets an indicator 
in the RTCT so that IEAVTSDC will issue message 
IEA994A to the operator. IEAVAD00 returns control to 
the caller with a return code of 8 in register 15. IEAVTSDC 
only issues this message the first time SVC dump finds all 

dump data sets full. It is not issued again until after SVC IEAVTSDH SDFULL 

dump has found an available dump data set and then used 

all of the available dump data sets. This dump data set 

checking and message processing is not performed for 

SYSMDUMP requests. 

If the SDUMP 4K buffer is requested and locked, SVC 

dump writes it on the dump data set. If IEAVTSDH is 

running on a processor with an active MSSF and the 

processor is not a part of a complex with a VM 

machine, IEAVTSDH uses SVC 122 to obtain the 

console loop trace data. If the console loop trace data 

has not been read before, IEAVTSDH calls IEAVTSDP IEAVTSDP 

to dump the console loop trace data on the dump data 

set. SVC dump writes the header record, including 

the TOD clock value, all of the register values, and 

the address of the caller, on the dump data set. 

IEAVTSDH builds an 8K address range table in the SDUMP IEAVTSDH SDHGLOBL 

workarea pointed to by CVTSDBF. This table is used by 

the rest of SVC dump processing to describe the storage 

areas to be dumped. For SYSMDUMP requests, a storage 

area acquired by ABDUMP is used instead of the SDUMP 

workarea. IEAVTSDH adds addresses of the following 

storage areas to the address range table: ASVT, ASCB for 

all requested address spaces, CVT, PSA of the current 

processor, and SCVT, GDA, PCCAVT, all PCCAs and 

UCBs, IOCOM and other IOS data areas, NUCMAP, TOB, 

and TRVT, LPA directory, ASTEs, three pages around the 

error PSW if the PSW points to global storage, and the 

address range table. 


Extended Description 


Module 


Label 


11 IEAVTSDG adds the address ranges for the global IEAVTSDG SDGLOBAL 

storage areas requested in the RTCT and the SDUMP 

parameter list to the address range table. IEAVTSDG dumps 

the following areas in the order listed: IEAVTSDO SDOUTPUT 

1. SQA 

2. CSA 

3. Trace tables 

4. PSA's 

5. Storage from requested global subpools 

6. Global storage requested in the caller's storage list 

7. Nucleus 

8. Storage dumped by any requested global dump exits 
(e.g. GRSQ). 

IEAVTSDG calls module IEAVTSDO to move the 
areas referenced in the address range table to the dump 
data set. IEAVTSDG sets the system dispatchable, if it 

was sat non-dispatchable, by a branch entry call to STATUS. IEAVTSDG SETSDISP 

12 If a summary dump was requested, IEAVTSSE calls IEAVTSSE OUTPUTP 
module IEAVTSDO at entry point IEAVTSDP to move IEAVTSDO IEAVTSDP 

the following areas to the dump data set: 

• Storage addresses specified with the SUMLISTor IEAVTSSE SUMLISTP 

SUMLSTA parameter on the SDUMP macro. 

• Any RTM2 work areas (RTM2WA) associated with the RTM2P 

failing task, 4K of storage before and after every valid, 

unique address in the program status word, and reg¬ 
isters for the failure that were saved in each RTM2WA. 
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IEAVAD00 — SVC Dump Processing (Part 12 of 12) 


Extended Description Module Label 

13 IEAVTSDL adds the address ranges for the local IEAVTSDL SDLOCAL 

storage areas requested in the RTCT and the SDUMP 

parameter list to the address range table. IEAVTSDL dumps 
the following areas in the order listed: 

1. Cross memory control tables: LT, ET, AT, and PC LINK 
stacks. 

2. Three pages around the error PSW if the PSW points to 
local storage. 

3. Local storage requested in the caller's storage li$+ 

4. Storage from requested local subpools. 

5. LSQA 

6. SWA 

7. RGN 

8. LPA 

9. Storage dumped by any requested local exits. 

IEAVTSDL calls IEAVTSDO to move the local areas IEAVTSDO SDOUTPUT 

referenced in the address range table to the dump 
data set. 

14 IEAVADOO calls module IEAVTSDU to deter- IEAVTSDU 

mine if any component-related data is to be 

included in the dump. If the trace teble option ITRTI is 
specified on Ihe SDUMP macro, IEAVTSDU loads snd 
calls the master trace dump exit (IEEMB879). Other¬ 
wise, processing continues at step 15. IEEMB879 deter- IEEMB879 
mines if the master trace is active and, if it is, invokes the 
SDUMP output service to write the master trace data on 
the dump data set. If the master trace is not active, 

IEEMB879 returns to IEAVTSDU. 

15 IIGTF it eclive, and TRT ha* been re- IEAVTSDF SOGTF 

quested, IEAVTSDF accesses the trace records 

gathered by GTF using the GTF READ service. As 
each GTF record is read, IEAVTSDF calls lEAVTSDPto 
write the record on th6 dump data set. 

16 SVC dump writes an end-of-file mark on the lEAVTSDC SDENDUP 

dump data set after the last dump record has been 

written. If the DCB parameter was not specified, 

lEAVTSDC issues message IEA911E to the operator ENDDS 

showing the unit address and data set name of the data 

set on which the SVC dump is located. If the indicator WR1TEMSG 

in the RTCT is set to issue message IEA9d4A, lEAVTSDC 


Extended Description 


Module 


Label 


issues this message to the operator. (lEAVTSDC does 
not issue this message if any tape dump data sets are used. 

If tape dump data sets are being used, lEAVTSDC issues 

•message IEA984E to inform the operator to mount a new 

tape.) lEAVTSDC calls IEAVTSD1 to begin post-dump IEAVTSD1 

exit processing. IEAVTSD1 obtains storage and copies 

the dump header record into this storage. IEAVTSD1 

posts IEAVTDSV and passes a copy of the dump header 

record. IEAVTDSV begins post-dump exit processing. 

IEAVTSD1 then returns to lEAVTSDC. If the system 
was set non-dispatchable, lEAVTSDC sets it dispatchable. 
lEAVTSDC removes any SVC dump serialization. Upon 
completion of this cleanup process, SVC dump returns to 
the caller with a return code in register 15 showing the 
success or failure of the dump operation. 
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SVC 61 
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IEAVAD01 — Snap Dump Processing (Part 2 of 14) 

Extended Description Module Label Extended Description Module 


The SNAP dump routines produce a formatted dump of 
various areas of storage, depending on the parameters. 

SNAP receives control from IEAVADOO when the SNAP 
macro is issued. 

The main SNAP module, IEAVAD01, does initialization and 
then routes control to IEAVADIN. IEAVADIN then invokes 
various formatting routines based on the SNAP options. 

These formatting routines format the dump. 

1 The SNAP routine obtains storage for an ABDAREA. IEAVAD01 SNPINIT 
This area contains save areas, output buffers, and work 

areas for the format routines. If this area can not be ob¬ 
tained, SNAP returns a return code of X'08' in register 15 
and IEAVTABD frees the copied trace table, if it was ob¬ 
tained. 

2 SNAP establishes an ESTAE to provide recovery for the IEAVAD01 SNPINIT 
dump process. The recovery routine (SNPRCVR) re¬ 
receives control when an error occurs. If this routine 

receives control, SNPRCVR issues an informational message 
'ERROR FORMATTING XX'. If an error occurs in SNAP 
mainline, SNPRCVR performs an SDUMP and RECORD. 

If the error occurred in a format routine, SNAP routes con¬ 
trol to the next format routine. Format routines, which in 
some cases expect a program check, cover their modules 
with an internal retry address. 


3 SNAP processing does not validity check the parameter IEAVAD01 
list for calls from ABDUMP, nor does SNAP enqueue 

upon the dump data set for calls from ABDUMP; ABDUMP 
has already performed the ENQ process. If SNAP encounters 
a bad TCB, it returns a return code of X'08' in register 15. 

If the current task is not being dumped, SNAP calls STATUS 
to set the task non-dispatchable. 

4 SNAP checks the validity of the DCB. If the DCB is 
not available, SNAP puts a return code of X'04' in 

register 15 and returns to the caller. If the DCB is not 
valid or not opened, SNAP returns a return code of X'OC' 
in register 15. 


Label 

SNPVALCK 


SNPCHK 
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IEAVAD01 — Snap Dump Processing (Part 3 of 14) 



Process 



5 Obtain storage for the 


INDEX and FORMAT 


work areas, and 
initialize them. 


• Error, 


g Initialize the address of 
the service routines for 
formatters and call 
IEAVADIN to invoke the 
formatters. 

> • Service routines 

-Format and print 
the dump. 


Output 
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IEAVAD01 - Snap Dump Processing (Part 

Extended Description 

5 SNPINDX obtains storage for the INDEX buffer and 
a work area to be used by the format routines. SNAP 

maintains this index during the dump process and prints 
it at the end of the dump. 

SNPROUT invokes IEAVADIN. IEAVADIN invokes the 
formatters depending on the dump options specified in the 
SNAP parmlist (IHASNP). This routine routes control to 
the formatters with register 1 pointing to the IHAABDA, 
register 13 pointing to the save area, and register 14 
pointing to the return address. 

6 All SNAP formatters use the following service routines 
to convert and print the dump. 

IEAVAD11 - This routine is the output routine and all 
format routines call it to print the lines of the dump on an 
output device. 

IEAVAD31 — This format routine unpacks and translates 
data in the print line, providing indentation. 

IEAVAD5T - This module translates data in the print 
line. 

IEAVAD71 - This module translates blocks of storage. 

The snap FORMAT routines use all of the formatting and 
output routines to produce printable format. 
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Modulo Label 
IEAVAD01 SNPINDX 

IEAVAD01 SNPROUT 

IEAVAD1I 

IEAVAD31 

IEAVAD61 

IEAVAD7I 
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IEAVAD01 — Snap Dump Processing (Part 5 of 14) 
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IEAVAD01 — Snap Dump Processing (Part 

Extended Description 

a # IEAVA D02 — This format routine displays the 

jobname, stepname, time, date, DUMPID, completion 
code, ILC (instruction length count), interruption code, 
and CPUID (serial number). 

b. IEAVAD10 — This format routine formats the PSW 
either at the time of the abend or at the time the 
SNAP macro was issued. 

C. IEAVADOB — This format routine provides the name 
and PSW address of the load module. The offset into 
the module where the error occurred is provided as the 
default output. 

d. I EA VAD03 — If the dump options specified included 
CB or SUM, this format routine displays the ASCB, 

CDE, TCB, RB queue, LLE queue, XTLIST, and TIOT. 
IEAVAD03 displays these control blocks by using the 
service aids exit interface. See "SPL Service Aids" for 
a description of this interface. 
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Module Label 
IEAVAD02 

IEAVAD10 

IEAVADOB 

IEAVAD03 
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IEAVAD01 - Snap Dump Processing (Part 7 of 14) 


Input 



e. Format the VSM storage map 
and TCB summary. 


f. Format the ENQ control blocks. 


g. Formal (he data management 
control blocks. 


h. Format the I/O supervisor 
control blocks. 


i. Format the error control 
blocks. 


j. Format the save areas and PC 
information. 


Output 
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IEAVAD01 — Snap Dump Processing (Part 

Extended Description 

e. IEAVAD05 — If the dump options specified included 
CB or SUM, this format routine formats the VSM 
storage map, SSAT and TCB summary. If the dump 
options specified included PCDATA, this format 
routine also formats the PC table. 

f • ISGDSNAP - If the dump options specified included 
the Q option, this format routine formats QCBs and 
QELs. 

g a IECDAFMT — This format routine displays the 
DCB, IOB and DEB. If the dump options specified 
included CB, this format routine formats the DEB. If 
the dump options specified included DM, this format 
routine formats all of the data management control 
blocks (DEB, DCB, IOB, LCB's, ICB's). 

h. IECIOFMT — If the dump options specified included 
10, this format routine displays the UCB and EXCPD 

related to the task being dumped. 

i. IEAVTFMT — If the dump options specified included 
ERR or SUM, this format routine displays the RTM2WA, 

the STAE control block and the EEDs related to the 
failing task. 

j. IEAVAD07 - If the dump options specified included 
SAH, SA or SUM, this format routine displays the 

save areas and PCLINK stacks. 
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Module Label 
IEAVAD05 

ISGDSNAP 

IECDAFMT 

IECIOFMT 

IEAVTFMT 
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IEAVAD01 — Snap Dump Processing (Part 10 of 14) 

Extended Description Module Label 

k. IEAVAD08 — This routine invokes the VTAM IEAVAD08 

(ISTRAFD1), TCAM (IGC0E054), VSAM 
(IDA0195A), and user (IGC0905A) formatters to format 
VTAM, TCAM, VSAM, and user control blocks if CB is 
specified as a dump option. If CB was the specified dump 
option, this routine tests the user format CSECT 
(IEAVADFM). If this CSECT contains any entries 
(MODULE NAMES), this routine loads these routines. SNAP 
invokes each entry in the list. If the TRT option was specified 
and GTF is active, SNAP invokes GTF (IGC0F05A) to print 
the GTF trace table. 

|, IEAVAD09 — This routine formats the PSA and IEAVAD09 

nucleus or the PSA and non-page protected 
nucleus if NUC was a requested dump option. This 
routine formats the PSA and the complete virtual 
nucleus if ALLVNUC was a requested dump option. 

m. IEAVAD0A — This invocation of the routine IEAVAD0A 

formats the local system queue area (LSQA). 

This routine receives control when LSQA is 
specified as a dump option. 

n. IEAVAD0E - This format routine formats the IEAVAD0E 

scheduler work area (SWA) if requested on the dump 

options. SNAP prints the SWA addresses from low to high. 

Subpools 229 and 230 are also formatted when LSQA 
is a requested dump option. 

O. IEAVAD0A — This invocation of the routine IEAVAD0A 

formats the system queue area (SQA). This 
routine receives control when SQA is specified as 
a dump option. 

p. IEAVAD10 — This invocation of the routine IEAVADI 0 

formats the registers at the time of. error. These 
registers are obtained from the RTM2 work area 
(RTM2EREG) if SUM was the requested dump 
option, or from the TCB (TCBGRS) if REGS was 
the requested dump option. 


Extended Description Module 

q. IEAVADSM — This routine formats part IEAVADSM 

of the summary dump information for 
SYSABENDand SYSUDUMP dumps if SUM 
was a requested dump option. This information 
includes the active load module, 1K of storage 
before and after the address contained in the 
PSW, and 1K of storage before and after 
the addresses contained in the registers at the 
time of error. No duplicate data is formatted. 


Label 
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Input 


Starting address 


STOR list STOR headers 

^HDR - 

Ending address ^HDR 

Starting address f H DR 

Ending address f HDR 


LEN I Header 


SUBPLST 



SPID SPID 


Copied trace 



Process 



Output 


r. Format the storage list 
and header. 


$. Format the JPA, LPA, and 
SVC modules. 


JEALR 


t. Format the 
subpools. 


U. Format the supervisor 
trace. 



m 

























LY28-1670-1 Cc) Copyright IBM Corp. 1987, 1989 Method of Operation DMP-79 


IEAVAD01 — Snap Dump Processing (Part 12 of 14) 


Extended Description Module 

r. IEAVADOF — This routine formats the areas specified IEAVADOF 

by the user storage list. If STORAGE HEADERS were 
specified, SNAP prints the headers above each storage range. 

S. IEAVADOB — This invocation of the routine formats the IEAVADG8 
JPA, LPA, and active SVC modules when JPA, LPA, or 
ALLPA is a specified dump option. 

t. IEAVADOD - This format routine formats the user IEAVADOD 

subpools (0—127 and 252). This routine is invoked if 
SPLS is a specified dump option. SNAP sorts all subpool data 
in ascending order by subpool number and prints the subpool 
data for the SPLS option. This routine is also called for 
SUBPLST option to display storage for specific subpools 
requested by the user. SNAP sorts the subpool data beginning 
with the lowest address within individual subpools, and prints 
the subpool data for the SUBPLST option. The SPLS option 
and the SUBPLST option are mutually exclusive. 


U. IEAVADOC — This routine builds the exit parameter list IEAVAD0C 
(IHAABDPL) and invokes the trace formatting routine 
(I EA VETFC). I EA VETFC formats and displays the trace 
table. I EAVADOC receives control if TRT and/or SUM 
are requested dump options. When TRT is specified for an 
authorized user, I EAVADOC displays the entire trace table. 

When TRT is specified for an unauthorized user, I EAVADOC 
displays only the trace entries for the current address space. 

If SUM Is specified, whether the user is authorized or un¬ 
authorized, I EAVADOC displays only the trace entries for 
the current address space. 


Label 
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Process 


7 Format the index. 


8 Clean up the resources 
and return. 


• Release all storage. 

• DEQ the dump data 
set, if a SNAP user. 
Otherwise, do not 
DEQ. 

• Remove recovery. 

• Exit. 
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IEAVAD01 — Snap Dump Processing (Part 14 of 14) 

Extended Description Module Label 

7 SNAP displays the dump index at the end of all dumps, IEAVADQ1 SNPINDX 
IEAVAD01 updates and maintains the index es the 
dump is processed. This index maintains all key areas' page 
numbers. IEAVAD01 displays the active modules in 
alphabetical order. 

0 SNAP cleans up all the resources it obtained and returns IEAVAD01 SNPCLNUP 
to the caller. SNAP frees the storage it obtained via a 
FREEMAIN, and dequeues the dump data set if the caller 
is not ABDUMP. SNAP deletes the ESTAE and returns to 
the caller. 
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IEAVTABD - ABDUMP Processing (Part 1 of 10) 


Input _ 

RTM2WA Input (from RTM2I 


RTM2DPLA 


RTM 

Control table 


RTM2DPPL 


Flags 1 I Reserved 


SDATA PDATA 
Options Options 


f Subpool list 


ubpool list 


No. of ID's 

Subpool 

ID 

Subpool 

ID 

Subpool 

ID 


Subpool 

Subpool 

ID 

ID 


From 

IEAVTRTC Process 


*| Determine whether 
this is a recursive 
entry. 


2 Set the scope of the 
dump. 


3 Take a symptom dump 
if requested. 

BALR 


4 Determine whether a 
dump should be 
taken. 


5 Determine if there are 
any pre-dump exits. 

LOAD + BALR 


IEAVTSYM 


Symptom 

information 


IEAVTABX 


Pre-dump 

exit 


Output 


RTM2WA 


RTM2DMP1 


Symptom Dump 


Message 

IEA995I 


IHAABEPL 


Storage list 


Beginning 

address 

Ending 

address 

Beginning 

address 

Ending 

address 

] 

C_ 3 

Beginning 

address 

Ending 

address 
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IEAVTABD — ABDUMP Processing (Part 2 of 10) 

Extended Description Module Label Extended Description Module Label 


Terminating tasks can request a storage display. RTM2 
provides the dump via ABDUMP processing. The RTM2WA 
contains the dump options for the terminating task; 

ABDUMP processing checks these options, prepares the 
dump data set, constructs a SNAP parameter list (for 
the actual dump), and gives control to SNAP processing 
(see the M.O. diagram SNAP Dump Processing 
(IEAVAD01) for the description of SNAP's operation). 

1 IEAVTABD protects itself from recursions by setting IEAVTABD ADRECOV 
indicators to denote external functions in control, 
and to denote the completion of external functions. 

IEAVTABD turns the in-control indicators off when con¬ 
trol returns from the external function. 

When an error accurs, IEAVTABD checks the first 
set of indicators (the in-control set) to determine if an 
external function had control. If an external function had 
control, control goes to a clean up subroutine, ADRCLN, 
to perform the necessary cleanup. 


If an external function did not have control, IEAVTABD 
determines the last completed function, initializes the 
new RTM2WA with information from the previous work 
area, and passes control to the appropriate routine in 
IEAVTABD to continue processing. 

This subroutine performs the necessary cleanup, requests 
an SVC dump, and gives control back to the caller. 

2 The scope of a dump can either be a single task if IEAVTRTC RTCADINT 

RETRY with dump has been requested from an ESTAE 
exit, or if the task has a subtask that is a job-step task; a 
failing task tree, if no recovery from the ABEND was 
accomplished, or a jobstep tree if no recovery was accom¬ 
plished and the ABEND is a step ABEND. If it is a RETRY 
with dump (RTM2DREQ-1 and RTM2RETR=1) situation 
or if the task has a subtask that is a jobstep, IEAVTRTC 
sets the RTM2DMP1 flag to 1 and places the current TCB 
address in the TCB field of the dump parameter list in the 
RTM2WA (SNPTCBA). If it is not a step ABEND from a 
subtask of a step (RTM2STPT-0), IEAVTRTC places the 
current TCB address in the SNPTCBA, otherwise 
IEAVTRTC places the address of the jobstep TCB 
in the field. 
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IEAVTABD - ABDUMP Processing (Part 4 of 10) 

Extended Description Module Label 

3 IEAVTABD checks the RTCT (recovery termination IEAVTABD 
control table) bits (RTCTISAB, RTCTISYU, and 
RTCTISYM) for a no-dump condition. If all the bits are one, 
no dumps (SYSABEND, SYSUDUMP, or SYSMDUMP) are 
wanted. The CHNGDUMP operator command sets these 
, flags and indicates to IEAVTABD that no dump is wanted. 

If the dumps are not being ignored, ABDUMP issues the 
R ACROUTE macro to determine if the user is authorized to 
receive the dump. If the return code is 0 or 4, the dump will 
be taken. Otherwise, the user is not authorized to receive the 
dump and message IEA8481 results. If the user is authorized 
to receive the dump, the RTM2WA bits (RTM2NODP, 

RTM2NOSA, RTM2NOSM, and RTM2NOSU) are checked for 

no dump. If all of these bits are on (*1 # B), no dumps 

(SYSABEND, SYSUDUMP, SYSMDUMP) are wanted and 

message IEA8481 results. These bits are set using the SLIP 

service and indicate to ABDUMP that no dump Is wanted. If 

any or all of these RTM2WA bits are off ('O'B), the TIOT is 

scanned for a DD entry for SYSABEND, SYSUDUMP, or 

SYSMDUMP. If one the the DDNAMEs is found and dumps 

are being taken for that DD type, the NOSYM bit (either 

RTCTABNS, RTCTSUNS or RTCTSYMN) for that DD type is 

checked. If the NOSYM bit is on, no SYMPTOM dump is 

taken. If none of the DDNAMEs is found, the NOSYM bit for 

the SYSUDUMP DD type (RTCTSUNS) is checked. If the 

NOSYM bit is on, control returns immediately to RTM2 with a 

return code of 0. If a SYMPTOM dump is taken, message 

IEA995I is issued using MLWTO, routing code 11. This IEAVTSYM 

message displays the PSW, registers, ERROR ID, abend code, 

and other information about the error. 


Extended Description Module 

5 If a dump is to be taken, module IEAVTABX is loaded to 
determine if there are any pre-dump exits to be given control. 
IEAVTABX is checked for the presence of any exit load module 
names. If a name is found, the pre-dump exit parameter list 
(IHAABEPL) is built, the exit routine is loaded, and control 
is given to the exit routine passing the IHAABEPL in register 1. 

Upon completion of all exits, the exits are deleted and the 
return code is checked to determine if the exit modified the 
dump options (RC=4), suppressed the dump (SLIP did not 
indicate no suppression, RC=8) or kept the original options 
(RC-0). IEAVTABX is deleted. If the dump options were 
changed (RC=4), the new SNAP parameter list is placed 
in the RTM2WA. If the dump was suppressed (RC=8),and 
SLIP ACTION=NOSUPPRESSION was not specified, 
message IEA848I is issued and control is returned to RTM2 
with a 0 return code in the RTM2WA. 


4 If one of the DDNAMEs is found on the IEAVTABD 

TIOT, the no-dump bit in the RTCT for 
the type of dump requested is checked. If 
the no-dump flag is on for the DD found, 
a further scan will be made of the TIOT 
to determine if any other dump DD is found. 

If no dump is to be taken, control returns 
to RTM2 with a 0 return code in the RTM2WA. 
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IEAVTABD - ABDUMP Processing (Part 5 of 10) 


Input 


HOT 

DDNAME 

DDNAME 

ODNAME 

TIOEFJFCB 


RTM f 
control table 

ADD or OVER* 
Defaults 
Overrides 


Process 





—V ® 

Enqueue on the dump 
data set. 

7 

Determine the format and 
initialize the DCB. 

8 

Open the dump data set. 


Output 


Register 14 Register 15 Register 13 


Return address I I Entry address 11 Save address 
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IEAVTABD — ABDUMP Processing (Part 6 of 10) 

Extended Description Module 

6 IEAVTABD enqueues on the dump data set using the 
option RET=HAVE # a major name of SYSIEA01 and 

a minor name of IEA. On a nonzero return code from ENQ, 
IEAVTABD issues an SVC dump and returns control to 
RTM2. 

7 IEAVTABD obtains storage for the DCB and parameter 
list from subpool 230. If DDNAME=SYSMDUMP, 

DSN«SYS1 .SYSMDPxx (xx can be 00-FF), and DISP=SHR 
are specified, IEAVTABD initializes the DCB with MACRF= 

(R,W), DSORG-PS, LRECL=41Q4, BLKSIZE=4104, RECFM= 

FB, and EODAD=DSRDEXIT. Otherwise, IEAVTABD 
initializes the DCB with DSORG=PS, MACRF=W, RECFM=VBA 
LRECL=125, and DDNAME as defined in the TIOT. 

8 IEAVTABD opens the DCB in TCB key (via 
MODESET). If unsuccessful <DCBOFOPN=0). 

IEAVTABD routes message IEA030I 'OPEN FAILED FOR 
DUMP DATA SET FOR JSJ' to the programmer. IEAVTABD 
returns control to RTM2 with a return code of 4. 
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Label 


Extended Description 


Module 


Label 


IEAVTABD - ABDUMP Processing (Part 8 of 10) 

Extended Description Module 


9 IEAVTABD determines the dump options for SNAP 
from the options passed by RTM2, the installation 
default options (specified in PARMLIB members IEAABDOO- 
SYSABEND, IEADMPOOSYSUDUMP, and IEADMRQ0- 
SYSMDUMP) or the installation override options with any 
installation additions (specified via the CHNGDUMP operator 
command). When more than one of these groups is available, 
the order of selection is as follows: 

a. When OVER is requested, the options specified via the 
CHNGDUMP operator command override the options 
specified via the PARMLIB members or passed by RTM2. 

b. If the caller uses the CHNGDUMP operator command 
with the ADD function of CHNGDUMP, IEAVTABD 
merges these options with options specified in the 
PARMLIB members (if available) and merges these 
with RTM2WA passed options, if available. 

c. Lacking CHNGDUMP options, IEAVTABD merges the 
options passed from RTM2WA with options specified in 
the PARMLIB members (if available). 

d. If no options were passed by RTM2, the PARMLIB 
options define the dump contents. However, if PARMLIB 
options are not present and no options were passed by 
RTM2, no dump is provided. 

If an abend 'x22' abend is in progesss, of if SUBTASKS was 
requested, IEAVTABD selects the options for TCBs (other 
than the input TCB) as follows, to prevent the display of 
redundant data: 

• The SDATA options NUC, SQA, LSQA, SWA, TRACE, 

QCB, PC, SUM, ALLVN are turned off for each subtask. 

• The SDATA options CB, DM, IO, ERR are left on if requested 
for the first task. 


10 Based on the type of dump requested, two different 
processes take place: 

SYSABEND/SYSUDUMP PROCESS 

After IEAVTABD has dumped the input TCB, it checks to 
determine whether an ABEND is in progress (RTM2DMP=0). 

If so, IEAVTABD calls STATUS to prevent the subtasks 
from terminating during dump processing. IEAVTABD dumps 
the subtasks of the abending task and the mother task. 
IEAVTABD sets TCBFS to one to indicate that it has 
dumped an abending task. On a nonzero return code from 
SNAP, IEAVTABD issues message IEA912I ‘RECOVERY/ 
TERMINATION DUMP FAILED' and returns control to 
RTM2 with a return code from SNAP stored in RTM2SNCC. 
Return codes from SNAP are: 

0 — Successful completion 

4 — DCB not opened, undefined page reference on DCB 
8 - TCB not valid, undefined page reference on TCB, 
insufficient storage, invalid parameter list, a 
subtask is a jobstep TCB 
12 — DCB type incorrect 


IEAVSETS 
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IEAVTABD - ABDUMP Processing (Part 10 of 10) 

Extended Description Module 

11 If SYSMDUMP DD entry is found, module IEAVTSYS IEAVTSYS 
is called to process the SYSMDUMP request. IEAVTSYS 
builds the SDUMP parameter list based on the dump options 
requested. The dump options are obtained from the CHNGDUMP 
operator command options, RTM2 passed options and SYS1. 

PARMLIB member IEADMROO. IEAVTSYS obtains storage for 
an SDUMP work area and SDUMP buffers. IEAVTSYS obtains 
the SDUMP buffers from 2 different storage areas. The first 
half is obtained from LSQA, and the second half is obtained 
from CSA user key. The address of these areas are passed 
to SDUMP via the SDUMP parmlist. A DECB is also built 
and the address is passed in the SDUMP buffer. 

When an abend is in progress (RTM2DMP1=0), IEAVTABD 
only takes one dump for each call from RTM2. On a zero 
return code from SDUMP, IEAVTSYS issues message IEA993I 
'SYSMDUMP taken to XXXX' and returns control to RTM2. 

On a return code of four, IEAVTSYS issues message IEA998I 


Label Extended Description Module 

'PARTIAL SYSMDUMP taken to XXXX' and returns 
control to ABDUMP. On a return code of eight from 
SDUMP, IEAVTSYS issues message IEA9121 
'RECOVERY/TERMINATION DUMP FAILED'and 
returns control to RTM2 with the return code from 
SDUMP stored in RTM2SNCC. If SDUMP passes a return 
code of twelve, IEAVTSYS issues message IEA838I, 

'SYSMDUMP SUPPRESSED AS A DUPLICATE OF: original 
dump information', and returns control to ABDUMP. 

Return codes from SDUMP are: 

0 - Complete dump was taken. 

4 — Partial dump was taken. 

8 — System was unable to take a dump. 

12 - SYSMDUMP was suppressed. 

12 IEAVTABD closes the dump data set, frees the DCB 
storage, sets the dump flag indicator (TCBFS=0) to zero 
if an abend was in progress, and dequeues from the dump 
data set. IEAVTABD ensures that the storage acquired by 
RTM2 for the copied trace table and the RBBUFFER used by 
SNAP is freed. If an abend was in progress, IEAVTABD sets 
the subtask dispatchable. 
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IEAVTDSV - DUMPSRV Address Space Jobstep Task (Part 1 of 2) 


via started task control 
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IEAVTDSV - DUMPSRV Address Space Jobstep Task (Part 2 

Extended Description Module Label 

IEAVTDSV is attached as the job step task in the DUMPSRV 
address space. It sets up the DUMPSRV address space task 
structure and provides the interface to SVCDUMP and 
SYSMDUMP for post SVCDUMP exit processing. It also sets 
up the address space for dump data set processing and for 
DAE processing. IEAVTDSV is invoked when the procedure 
DUMPSRV is read from SYSI .PROCLIB during system 
initialization; or IEAVTDSV is invoked by the SVCDUMP 
memory termination resource manager (IEAVTSDR) when 
the previous DUMPSRV fails. There is a program properties 
table entry for IEAVTDSV which contains the properties 
of the DUMPSRV address space. 

*| The dump data set processing task (IEECB926) is 
attached as a daughter of IEAVTDSV. It processes 
the DUMPDS command. An EXTR routine (IEAVTDSE) is 
provided to handle IEECB926 task termination. The 
IEECB926 task is a never-ending task unless a non-recoverable 
error occurs. 

2 IEAVTDSV attaches ADYTRNS, the dump analysis 
and elimination (DAE) transaction processor, as a 

daughter of IEAVTDSV. ADYTRNS processes transactions 
for all DAE functions. IEAVTDSV provides an end-of-task 
exit routine (IEAVTDSE) for ADYTRNS task terminations. 

ADYTRNS is a never-ending task and only stops when a 
non-recoverable error occurs. 

3 IEAVTDSV tries to locate the post dump exit list 
(IEAVTSEL) by using LOAD. If it is found, 

IEAVTDSV obtains storage for a table (DSVEXITL) from 
subpool 0, and places its address in the DSVC8 (DSVEXITS). 

For each exit in IEAVTSEL, IEAVTDSV issues a LOAD. If 
the LOAD is successful, IEAVTDSV stores the module entry 
point in the DSVEXITL table. If a LOAD fails for any of 
the exits, IEAVTDSV issues message IEAV833I. If no valid 
exits are found, IEAVTDSV frees the DSVEXITL table 
(using module IEAVGMOO) and clears the pointer to it 
(DSVEXITS). If at least one valid exit is found, IEAVTDSV 
obtains storage so that SVCDUMP can provide the post 
dump exits with a copy of the dump header. IEAVTDSV 
places the address of this 4K storage area in the RTCT 
(RTCTCPYH). IEAVTDSV then issues a DELETE for 
IEAVTSEL. 


of 2) 

Extended Description Module Label 

4 IEAVTDSV issues a WAIT, waiting for the SVCDUMP 
post-dump exit processor (IEAVTSD1) to post the 
ECB (DSVEECBE) to initiate the post exit processing. 

g IEAVTDSV issues an ENQ on the post dump exit 

resource (SYSIEA01 SDPOSTEX) in order to serialize 
the post dump exit processing request queue. The queue is 
anchored in the DSVCB (DSVEANCH). IEAVTDSV 
removes a post-dump exit parameter list (PDEP) element 
from the queue for processing. The PDEP contains a copy of 
the dump header record and a DAE post-dump parameter 
list (DSPD). IEAVTDSV then issues DEQ to release the post 
dump exit resource. If the queue was empty, IEAVTDSV 
returns to step 4 to wait for the next post dump exit request. 

Q If the queue was not empty, IEAVTDSV attaches 
the SVCDUMP post exit processor (IEAVTSEP) as a 
daughter of I EAVTDSV. IEAVTDSV passes the PDEP as 
input to the post dump exit processor. IEAVTDSV returns 
to step 5 to check whether or not there are any more 
requests to process. 

If the ATTACH of IEAVTSEP is unsuccessful, IEAVTDSV 
frees the PDEP. IEAVTDSV issues a WAIT so that the 
DUMPSRV address space is placed in a never-ending wait to 
keep the IEECB926 task active. 

Recovery processing 

Recovery is provided by an ESTAE (ESTAEDSV). If 
IEAVTDSV fails to attach IEECB926, the ESTAE issues a 
retry to IEAVTDSV to attempt to process SVCDUMP post 
exits. If an error occurs during the post exit processing the 
ESTAE issues a retry to IEAVTDSV, putting post exit 
processing in a permanent wait, but allowing the IEECB926 
task to remain active. The ESTAE records ail errors and 
issues an SVCDUMP. If the task fails to recover, the 
DUMPSRV address space terminates and the SVCDUMP 
memory termination resource manager (IEAVTSDR) gets 
control to clean up any critical resources. 
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ZEAVTSDB - MODULE DESCRIPTION 


DESCRIPTIVE NAME: SVC Dump Disabled Interrupt Exit (DIE) Processor 
FUNCTION: 

IEAVTSDB protects critical SVC Dump resources through the 
use of disabled interrupt exits (DIEs). IEAVTSDB protects 
the summary dump real storage buffer (RSB) and system 
non-dispatchability. IEAVTSDB also protects the suspended mit 
of work during suspend summary dump processing* 

ENTRY POINT: IEAVTSDB 

PURPOSE: See function. 

LINKAGE: CALL 

CALLERS: 

IEAVADOO* 

IEAVTSDT 9 
IEAVTSDX, 

IEAVTSSD 

INPUT: 

SDDIE contains a function code to indicate which 
function IEAVTSDB is to perform* SDDIE also contains 
pointers to all the working storage necessary for 
IEAVTSDB to run. There are two SDDIE control blocks 
in the system: one for the real storage buffer timer 
DIE and the other for the non-dispatchability timer 
DIE. 

OUTPUT: 

. Adds a TQE to the timer queue which establishes the 
non-dispatchability DIE. 

• Schedules an SRB which adds a TQE to the real timer queue 
which establishes the RSB DIE. 

EXIT NORMAL: Returns to the caller* 

EXIT ERROR: No exit error conditions* 

ENTRY POINT: RSBSRB 

PURPOSE: 

RSBSRB establishes the RSB timer DIE by invoking the SETDIE 
timer service. 

LINKAGE: CALL 

CALLERS: Dispatcher 

INPUT: 

SDDIE contains: 

. The first base register 
. Storage for the TQE 

. The time interval indicating how often the DIE is to receive 
control. 

OUTPUT: 

. The TQE for the RSBDIE is placed on the timer queue. 

. Register 7 is set up to point to SDDIE at the time of the 
SETDIE* This causes register 7 to be pointing to SDDIE when 
the DIE is entered. 

EXIT NORMAL: Returns to the dispatcher. 

EXIT ERROR: No exit error conditions. 
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IEAVTSDB - MODULE DESCRIPTION (Continued) 


ENTRY POINT: SDBDIE 

PURPOSE: 

SDBDIE is a general purpose DIE which handles the DIE interface 
for the RSB DIE and the non-dispatchability DIE. 

LINKAGE: CALL 

CALLERS: External interrupt TIMER SLIH. 

INPUT: 

SDDIE contains: 

. Work areas 
. Storage for the TQE 

• The time interval indicating how often the DIE is to receive 
control. 

OUTPUT: 

• Resources are cleaned up by the RSBDIE and NDISPDIE 
subroutines. 

. If any resources remain to be protected* the TQE for the DIE 
is placed back on the timer queue. 

EXIT NORMAL: Returns to the external interrupt TIMER SLIH. 

EXIT ERROR: No exit error conditions. 

ENTRY POINT: NDISPSRB 

PURPOSE: NDISPSRB sets the system or tasks dispatchable. 

LINKAGE: CALL 
CALLERS: Dispatcher 
INPUT: 

SDDIE contains: 

• The first base register 

• Storage for use by the SRB. 

OUTPUT: Various parts of the system are set dispatchable. 

EXIT NORMAL: Returns to the dispatcher. 

EXIT ERROR: No exit error conditions. 

ENTRY POINT: SDBFRR 

PURPOSE: 

SDBFRR is a functional recovery routine (FRR)• It recovers from 
errors in IEAVTSDB. 

LINKAGE: Call 

CALLERS: RTM 

INPUT: 

FRR parameter list (mapped by FRRPARM) which contains the 
following: 

. Base register 

• Data register 

. Address of SDDIE 

. Flags indicating which resources need to be recovered. 

OUTPUT: 

. The system diagnostic work area (SDWA) and the variable 
recording area (VRA) are filled in with diagnostic data. 

• Recording to SYS1.L0GREC is requested. 
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ZEAVTSDB - MODULE DESCRIPTION (Continued) 


EXIT NORMAL; Return to RTM. 

EXIT ERROR: No exit error conditions. 

EXTERNAL REFERENCES: 

ROUTINES: 

IARXPLCK - Obtains RSM serialization. 

IARXPRSB - Frees RSM serialization for the real storage buffer. 
IEAVESRT - Resets the SVC Dump caller for STOP/RESET functions. 

SETDIE - Establishes a TQE on the timer queue. 

CONTROL BLOCKS: 


Common name 

Macro Name 

Usage 

ASCB 

IHAASCB 

read 

ASVT 

IHAASVT 

read 

ASXB 

IHAASXB 

read 

CVT 

CVT 

read 

FRRS 

IHAFRRS 

read, write 

OUCB 

IRAOUCB 

read 

PSA 

IHAPSA 

read 

PVT 

IHAPVT 

read 

RB 

IHARB 

read 

RB 

IKJRB 

read 

RTCT 

IHARTCT 

read, write 

RTSD 

IHARTSD 

read, write 

SCVT 

IHASCVT 

read 

SDDAT 

IHASDDAT 

read 

SDDIE 

IHASDDIE 

read, write 

SDRSN 

IHASDRSN 

write 

SDUMP 

IHASDUMP 

read 

SDWA 

IHASDWA 

read, write 

SDWORK 

IHASDWRK 

read, write 

SMDLR 

IHASMDLR 

read 

SMWK 

IHASMWK 

read, write 

SMWKRSCB 

IHASDRSB 

read, write 

SRB 

IHASRB 

read, write 

SVT 

IHASVT 

read 

TCB 

IKJTCB 

read 

TPC 

IEAWTPC 

read 

TQE 

IHATQE 

read, write 

VRAMAP 

IHAVRA 

read, write 


TABLES: No tables used. 

SERIALIZATION: 

IEAVTSDB uses: 

• The dispatcher lock to serialize the TQE element 

• RSM locks to serialize the RSB 

• The local lock to serialize calls to STATUS 
. SDDIESER to serialize the SDDIE storage 

. RTCTSDPL and CVTSDBUFChigh-order bit) are set 
to serialize all of the SVC dump process. 
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IEAVTSDB - MODULE OPERATION 


IEAVTSDB receives control to protect the summary dump real storage 
buffer (RSB) and system non-dispatchability. IEAVTSDB establishes 
disabled interrupt exits (DIEs) to protect these resources. A DIE 
is a routine that receives control (disabled) at specified 
intervals for I/O and external interrupts. IEAVTSDB uses a timer 
queue element (TQE) to identify when the DIE receives control and 
to provide the address of the DIE. 

IEAVTSDB has five entry points. 

Entry point IEAVTSDB performs the following: 

• Schedules an SRB which establishes a DIE to protect the summary 
dump real storage buffer (RSB). The RSB contains the summary 
dump data. IEAVTSDB needs an SRB because the SETDIE service 
requires the dispatcher lock and higher locks may be held 

on branch entry SVC dump invocations of this module. 

• Establishes a DIE to protect the system non-dispatchability. 

This DIE also protects the system from resource deadlocks 
during suspend summary dump processing. 

Entry point RSBSRB establishes a DIE to protect the summary dump 
RSB. RSBSRB uses the SETDIE service to establish the DIE. 

Entry point SDBDIE passes control to the DIE routines which 
protect the system resources. 

• Subroutine RSBDIE protects the RSB. RSBDIE frees RSB frames 
when SVC Dump appears to hang while holding real frames in 
the RSB. This condition occurs when no RSB frames are freed 
within a DIE time interval. The RSBDIE frees the RSB frames to 
prevent SVC Dump from indefinitely holding on to real storage. 

• Subroutine NDISPDIE protects system non-dispatchability and 
the suspend summary dump process. NDISPDIE determines if 
SVC Dump is hung with the caller's unit of work stopped 
for suspend summary dump processing. SVC Dump determines 
this by examining a count of the number of virtual storage 
buffer blocks filled. If this count remains the same across 
the DIE time interval> SVC Dump is hung. The DIE resets 
the suspended unit of work to try to relieve possible 
system resource contention involving that suspended unit of 
work. 

Subroutine NDISPDIE then determines if SVC DUMP is hung while 
the system or tasks are set non-dispatchable. SVC Dump 
determines whether it is hung by examining a count of the 
number of records written to the dump data set. If the count 
remains the same across the DIE time interval, SVC Dump is hung. 
The DIE schedules an SRB to reset the system or tasks 
dispatchable. The SRB is required because the DIE cannot obtain 
the local lock which is needed for branch entries to STATUS. 

Entry point NDISPSRB invokes STATUS to set the system or tasks 
dispatchable. Subroutines NDISPDIE or NDISPSRB schedule this SRB. 

RECOVERY OPERATION: 

Entry point SDBFRR is the functional recovery routine (FRR) 
that provides recovery for all entry points in IEAVTSDB. 

It does the following: 

• Fills in the SDWA with diagnostic data. 

• Fills in the VRA with component data. 

. If possible, retries the request. 

. Frees locks which were obtained by IEAVTSDB. 

. Releases SDDIE serialization. 

. Returns to RTM. 
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IEAVTSDB - DIAGNOSTIC AIDS 


ENTRY POINT NAMES: IEAVTSDB 
RSBSRB 
SDBDIE 
NDISPSRB 
SDBFRR 


MESSAGES: None 


ABEND CODES: None 


WAIT STATE CODES: None 


RETURN CODES: 

EXIT NORMALS 

Decimal values in field SDHARCDE: 

0 - Percolate the error. Any FRRs established prior to this 
one receive control 
4 - Retry the request. 


REGISTER CONTENTS ON ENTRY: 
ENTRY POINT IEAVTSDB: Irrelevant 
ENTRY POINT RSBSRB: Irrelevant 


ENTRY POINT SDBDIE: 


Register 

0 

Register 

1 

Registers 

2-6 

Register 

7 

Registers 

8-10 

Register 

11 

Register 

12 

Register 

13 

Register 

14 

Register 

15 


- Irrelevant 

- Address of the TQE 

- Same as when the SETDIE was issued 

- Address of the SDDIE 

- Same as when the SETDIE was issued 

- First base register 

- Second base register 

- Irrelevant 

- Return address 

- Entry point address 


NOTE = The SETDIE service saves registers 2-12 at the time the 
SETDIE is issued. These registers are restored on 
entry to the DIE. 


ENTRY POINT NDISPSRB: Irrelevant 
ENTRY POINT SDBFRR: 

Register 0 - Address of 200-byte FRR work area 

Register 1 - Address of the SDWA 

Registers 2-13 - Irrelevant 

Register 14 - Return address of RTM 

Register 15 - Entry point address to the FRR 


REGISTER CONTENTS ON EXIT: 

EXIT NORMAL: 

Registers 0-13 - Unpredictable 
Register 14 - Unchanged 
Register 15-0 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor 


STEP 01 


IEAVAD00, IEAVTSDT, IEAVTSDX, 
IEAVTSSD n 


o 

IEAVTSDB 


IEAVTSDB protects critical SVC Dump 
resources through the use of disabled 
interrupt exits (DIEs). IEAVTSDB protects 
the summary dump real storage buffer (RSB) 
and system non-dispatchability• IEAVTSDB 
also protects the suspended unit of work 
during suspend summary dump processing. 


XHASDDIE 


SDDIESAV SDDIEWKA■ 


\ |01| Establishes addressability. 


XHASDDIE 


SDDIEFNC 


XHASDDIE 


|SDDIEARS 

IHASDRSB 


. SMWKFRHD 


XHASDDIE 

SDDIEAND 

IHASMWK 


SrWKVBUS 


02 Calls ADDRECOV to establish 
1 — 1 an FRR. 

/'-K,- 

ADDRECOV 


Selects the requested 
function. 


A. When the request is to add the DIE for 
\ the RSB, calls SCHSRB to schedule the 
/ SRB, RSBSRB, which establishes the RSB 
DIE. 


SCHSRB: 06 


> B. When the request is to add the DIE to 
\ cover non-dispatchability, calls 

/ ESTABDIE to establish the 

non-dispatchability DIE. This DIE also 
protects the suspend summary dump 
process• 


KXHASDDXE 


SDDIEMNR 

SDDIEBR 

SDDIEWA 



\XHASDDXE 


SDDIEVBU 


ESTABDIE: 40 


XHAPSA 


IPSACSTK 


Deletes the FRR. 


->IHAPSA 


PSACSTK 


KIHAPSA 


05 Returns to the caller. 




PSANSS 

•\XHASDDXE 

}/ ] -1 

SDDIEMNR 
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SRBKRl)) SCOPE(GLOBAL) LLOCK(NO) FRRINO) 


10 Returns to the subroutine's 
— 1 caller. 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor STEP 11 




XHASDRSB r->14 If any real frames are held* 

calls ESTABDXE to establish 
the DIE. 
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IEAVTSDB - SVC Dump Disabled interrupt Exit (DIE) Processor 


STEP 19 


XHASDDIE 


SDDIESAV SDDIEWKA 
SDDXEENT 


XHARTCT 



RTCTSDPL 


XHASDDXE 


XHASDDXE 


SDDIEFNC 


XHASDDXE 


SDDIEARS 


XHASDDIE 


SDDIEAND 


XHASDDIE 


XHASDDXE 


SDDIETQP SDDIETZM 



Establishes addressability. 


If an SVC Dump is in 
progress or a previous 
attempt to reset the system 
dispatchable failed, 
performs DIE processing. 


A. Calls ADDRECOV to establish an FRR. 


ADDRECOV 


->| B. Selects on the requested function. 


MHASDDXE 


-> C. When the request is to protect the RSB> 
calls the DIE routine, RSBDIE. 


RSBDIE: 22 


-> D. When the request is to protect the 

system non-dispatchability or suspend 
summary dump process, calls the DIE 
routine, NDISPDIE. 


NDISPDIE: 27 


E. If the protected resources are still in 
use, requeues the timer queue element 
(TQE) on the timer queue. Obtains the 
dispatcher lock and calls TQENQ to put 
the TQE on the timer queue. Then 
releases the dispatcher lock. 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DXE) Processor 


STEP 22 


XHASDRSB 

SMWXFRHD 

XHASDDXE 


SDDIEFRH 


XHASDRSB 


SMNKFRHD 


XHASMUK 


SMKKRSBL 


XHASDRSB 


SMWKLOKZ 


>221 Protects the real storage 
—\/ — 1 buffer (RSB) from errors in 

rsbdie SVC Dump. 


> [23J Ensures the RSB exists. 

If not, returns to the subroutine's 
caller. 


If no frames were freed 
during the last DIE 
interval* frees the real 
storage frames. 


This occurs only when SVC Dump has 
encountered an error. If no frames have 
been freed in the last three DIE intervals, 
RSBDIE frees the entire RSB. Otherwise, 
RSBDIE frees two frames. 

A. Calls IARXPLCK to obtain serialization 
for RSM processing. 

Note that this service leaves the RSN 
FRR on the FRR stack. This protects the 
RSM lo cks.^ 

\ i-,/| IARXPLCK 


KIHASDRSB 
1 IsmwkfcdeI 


XHAPSA 


PSANSTK 


XHASDRSB 


SMWKFRHD SMWKFRMA 


XHAPSA 


PSACSTK 


XHASDDXE 


SDDIETTL SDDIENOF 
SDDIEFRE 


XHASMUK 


SMMKRSM SMWKRSTX 


SMWKFRUS 

n 


XHASDRSB 


SMWKFUSE SMWXFALL 


XHASDRSB 


SMWKFRHD 


B. Sets up a second FRR to protect 
IEAVTSDB. This FRR prevents the RSM FRR 
from getting control for errors in 
IEAVTSDB. If this second FRR percolates 
to the RSM FRR, the RSM FRR frees the 
entire RSB and releases the RSM locks. 

C. Calls IARXPRSB to free the real frames. 




->XHAPSA 

PSACSTK 

KIHAPSA 

i/|- 

PSANSS 
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IEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor 


STEP 24D 


IHAPSA 

PSACSTK 

IHASDRSB 


0. Deletes the second FRR. This must be 
done before freeing the RSM 
serialization. 

E. Calls IARXPRSB to free the RSM locks. 


-MHAPSA 



MHAPSA 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE1 Processor 


STEP 29 


ZHASDDIE 


SDDIEND SDDIESRA 
SDDIESRR SDDIEIOC 


IHASDWRK 


SDHIOCNT 


IHARTCT 


RTCTSDND 


IHASDDIE 


IHARTCT 
RTCTSDF3 RTCTSDAN 
IHARTCT 


. RTCTSDAS 



Checks for system or task 
non-dispatchability. 


KIHASDDIE 


IHASDDIE 


SDDIESAS 


IHASDDIE 


SDDIESAS 


IHASDWRK 


SDWIOCNT 


XHASMWK 


SMWKVBUS 



A. If SVC Dump still has the system set 
non-dispatchable or SVC Dump has 
previously attempted to set the system 
dispatchable but STATUS failed* sets up 
master scheduler's address space as the 
target of the SRB. 


B. Else determines if any tasks are still 
non-dispatchable in any address space 
involved in the SVC Dump. 

If tasks are non-dispatchable* calls 
TESTASID to determine if an SRB can be 
successfully scheduled in this address 
space. 


TESTASID 


C. If a valid ASID was found* calls SCHSRB 
to initialize and schedule the SRB* 
NDISPSRB. 

/ { - l \|- 1 

\i-i/l SCHSRB: 06 




SDDIEIOC 

SDDIEVBU 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor STEP 30 


XHASMWK 


SMWKRSET SMWKSTOC 


XHASDDXE 

I 

SDDIEND SDDIEREQ 

E 

XHARTCT 

1 

RTCTSDND RTCTSDF3 

■ 

RTCTSDAN 



XHASDDXE 


SDDIESUS SDDIESYS 

SDDIETSK 


J\ 

V 


30 



Xf the system or tasks are 
still non-dispatchable or if 
the caller of SVC Dump is 
stopped for suspend summary 
dump processing* sets an 
indicator which causes the 
TQE to be requeued. 


Returns to the subroutine's 
caller. 


J \XHASDDXE 


SDDIEREQ 

SDDIETIM 


tH 


Dispatcher 

c> 

NDXSPSRB 


XHASDDXE r -> 



■ 

XHARTCT 

H 

RTCTSDPL 

■ 

XHASDDXE 

_j 

SDDIESAV SDDIEWKA 

— 

SDDIEBR 



XHARTCT 


RTCTSDND 


XHASDDXE 


SDDIEND 


32 


Sets the system and the 
tasks in an address space 
dispatchable. 


33 


Establishes addressability. 


34 Calls ADDRECOV to establish 
— 1 an FRR. 



ADDRECOV 


35 


Attempts to obtain the local 
lock. 


36 


Xf the local lock was 
obtained* continues 
processing to set the system 
or tasks dispatchable. 


A. If the system is non-dispatchable* calls 
STATUS to set the system dispatchable. 



J \XHASDDXE 


SDDIESRA 

SDDIESRR 


-KIHASDDIE 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor 


STEP 36B 


XHASDDZE 


SDDIETTL SDDIETSK 
SDDIEFRE 


IHARTCT 


RTCTSDAS RTCTSDAN 


XHASDDXE 


.SDDIEASI SDDIESAS 


J \l B. Updates the DIE footprints. 


KIHASDDXE 



XKJTCB 


Itcbntc tcbtid 


XHAASCB 


ASCBDUMP 


XHAASXB 


ASXBFTCB 


XKJTCB 


jTCBLTC j 

XHASDDXE 

SDDIEASI 

XHASDDXE 

SDDIETTL SDDIESAVr 
SDDIEFRE 


IHARTCT 


RTCTSDND RTCTASCB 


XHASDDXE 


XHAPSA 


-> D. Updates the DIE footprints. 

K 

l/ 

E. Releases the local lock. 


371 If the local lock could not 
1 — 1 be obtained* attempts to 

locate another address space 
where the local lock is 
available. 

-> A. If the system is still non-dispatchable* 
J \ attempts to schedule the SRB to the 
]/ DUMPSRV address space. 




KXHARTCT 

-1 

RTCTSDAN 

KXHASDDXE 

1/1-1 

SDDIETTL 

SDDIEFRE 

] \XHASDRSN 

IsdrtoispI 


\XHASDDXE 

ISDDIESASI 


\XHASDDXE 

ISDDIESASI 


XHAASCB 


1ASCBASID 


LY28-1670-1 (c) Copyright IBM Corp. 1987* 1989 


Method of Operation DMP-107 

















"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


IEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor 


STEP 37B 


IHASDDXE 


B. If the tasks are non-dispatchable in 
another address space involved in the 
SVC Dump, attempts to schedule an SRB to 
that address space. 


MHASDDXE 



43 If the TQE was queued 
— 1 successfully# Indicates 
this. 


MHASDDXE 

^IsddietqaI 
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XEAVTSDB - SVC Dump Disabled Interrupt Exit (DIE) Processor STEP 44 


44 


Returns to the subroutine's 
caller. 



IHASDWA 


SDWAPARM p-| 


XHASDDXE 



SDDIEWKA SDDIEBR | 

H 

XHASDDXE 

s 

SDDIEFNC 



IHASDWA 

IsDHACLUP 


RTM 


> 

\ / 
SDBFRR 


V 


45 


Provides recovery for every 
entry point in lEAVTSDB. 


46| Establishes addressability. 


47 


48 


49 


51 


Fills in the SDWA with 
diagnostic information. 


Fills in the VRA with the 
following problem 
determination data: 

. FRR 6-word area 
. SDDXE 
. SMWK fields 
. RTCT ASXD table 
. TQE 


Xf percolation is required* 
releases the SDDXE 
serialization and indicates 
to RTM that the dispatcher 
and local locks are to be 
freed if held. 


501 Xf percolation is not 
required* retries the 
request. 


Returns to RTM. 




J\IHASDWA 


SDWADISP 

SDWAFLLK 


JMHA8DWA 


SDWAMODN 

SDWACSCT 

SDWAREXN 

SDWACID 

SDWAMLVL 

SDWARRL 


J \IHASDRSB 



JMHASDDIE 


SDDIEDIR 

SDDIESRR 

SDDIEKNR 
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IEAVTSDR — SVC Dump/DUMPSRV Resource Manager (Part 1 of 6) 


Input 


Register 1 


From IEAVTMMT 
for memory termination 
From IEAVTSKT 
for task termination 

Process 


From RTM 

for SRB's FRR 



1 if entered in SRB mode, 
clean up resources. 

3. Set system dispatchable. 


b. Set address space swappable. 


C. Free the real storage buffer. 


d. Reset the caller. 


6. Set tasks dispatchable. 


f. Free the trace table. 
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IEAVTSDR — SVC Dutnp/DUMPSRV Resource Manager (Part 

Extended Description Module Label 

IEAVTSDR has three major functions: 

o Contains the FRR for the SDUMP SRB (label SCHSRB 
in IEAVTSDX). This FRR cleans up any critical system 
resources that SDUMP held. 

o Is the task and memory termination resource manager 
for address spaces and dump tasks (1EA VTSDT) 
involved in an SDUMP. 

o Is the memory termination resource manager for the 
DUMPSRV address space. 

1 If IEAVTSDR is entered in SRB mode, it is running as 
the FRR for the SRB (label SCHSRB in IEAVTSDX). 

IEAVTSDR does the following to clean up resources if 
necessary: 

a. If this is the first SRB to run, IEAVTSDR sets the 
system dispatchable. 

b. If the SRB issues a SYSEVENT DONTSWAP, IEAVTSDR 
sets the address space in which the SRB is running, 
swappable. 

C. IEAVTSDR frees the real storage buffer by taking the 
following steps: 

• Obtains the CPU lock to provide disablement 
o Calls IARXPLCK to obtain RSM serialization 
o Calls IARXPRSB to free the real storage buffer 

• Calls IARXPRSB to free RSM serialization 

• Frees the CPU lock 


2 of 6) 

Extended Description Module Label 

d. If a suspend summary dump was being processed 
and the SRB in the DUMPSRV address space failed, 

IEAVTSDR resets SDUMP's caller to prevent terminating 
the caller. IEAVTSSD performs the STOP. 

e. IEAVTSDR sets the tasks in the address space 
dispatchable if the SRB set them non-dispatchable. 

f. If SDUMP obtained the trace table, IEAVTSDR issues 
a SNAPTRC FREE to free it. 

9” If SDUMP's caller specified the ECB option on the SDUMP 
SDUMP macro, IEAVTSDR posts the caller's ECB using, 
cross memory post. IEAVTSDR does not post the 
caller if the caller's memory is terminating. 

h. |f the SRB that failed is the first, last or only SDUMP 
SRB, and the dump cannot continue, IEAVTSDR unlocks 
SDUMP. 
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IEAVTSDR - SVC Dump/DUMPSRV Resource Manager (Part 3 of 6) 
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IEAVTSDR - SVC Dump/DUMPSRV Resource Manager (Part 4 of 6) 

Extended Description Module Label 

2 If IEAVTSDR is not entered in SRB mode, it is running 
as the task or memory termination resource manager. The 
resource manager parameter list (RMPL) contains bits that 
indicate normal/abnormal and task/address space termination 
as well as the TCB and ASCB address of the terminating 
function. IEAVTSDR performs the following cleanup only 
if SDUMP is active and the terminating task or memory is 
involved in the SDUMP. 

a. Frees the real storage buffer as in step 1c. 

b. Sets the system dispatchable. 

C. Frees the trace table as in step 1 f. 

d. If IEAVTSDR is in control to handle the dump task 
(IEAVTSDT) failing in the DUMPSRV address space, 
and it is running a suspend summary dump, IEAVTSDR 
page-releases the virtual storage buffer. 

e. Resets SDUMP's caller as in step 1 d. 

f. Posts SDUMP's caller as in step 1g. 

g. Unlocks SDUMP as in step 1h. 
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IEAVTSDR — SVC Dump/DUMPSRV Resource Manager (Part 6 of 6) 


Extended Description Module 

3 If IEAVTSDR is entered for a normal or abnormal 
termination of the DUMPSRV address space, 

a. IEAVTSDR issues an ENQ on the post dump exit resource 
name to serialize cleanup with a possible SDUMP. If the 
ENQ is successful, the common storage on the post dump 
exit processing queue is freed. IEAVTSDR issues a DEQ 
on the post dump exit resource name. 

b. IEAVTSDR clears flags and fields in the RTCT and 
DSVCB to prevent any future DUMPDS commands, 
suspend summary dumps, or post exit processing. 


Label Extended Description Module 

f. IEAVTSDR issues message IEA607E/I to indicate 
whether the DUMPSRV address space is going to be 
restarted. 

9> If the address space is to be restarted, IEAVTSDR links 
to module IEAVTSAS to perform the call to the system 
address space initialization function. If the address space 
create fails, IEAVTSDR issues message IEA768I to 
inform the operator. 


C. If a DUMPDS command was being processed by 
IEECB926, IEAVTSDR posts IEECB923 to allow the 
command to complete. 

d. IEAVTSDR marks all entries on the SDUMP data set 
queue (SDDSQ) that were added with the DUMPDS 
command as unusable. IEAVTSDR issues message 
IEE340E for each data set that is marked unusable. If a 
SYS1.DUMP tape was added with DUMPDS, IEAVTSDR 
calls IEFAB49C to rewind and unload the tape. 
IEAVTSDR clears the attention index in the UCB to 
indicate the tape is 00 longer controlled by SDUMP. 


e. IEAVTSDR cleans up DAE resources. IEAVTSDR does 
the following: 

• Resets the current DAE default options to stop DAE. 

• Deletes the DAE low-priority transaction queue. 

• Deletes the DAE high-priority transaction queue. 

• Frees the storage for each entry in the high-priority 
queue. 

• Deletes any outstanding DAE operator messages via the 
DOM macro instruction. 

• Deletes the DAE in-storage symptom queue via the 
CPOOL DELETE macro instruction. 


Label 


"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



DMP-116 MVS/XA SLLs Dumping Ser LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 


IEAVTSDT — Resident Dump Task Processing (IEAVTSDT) (Part 1 of 6) 



"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 



































LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 Method of Operation DMP-117 


IEAVTSDT — Resident Dump Task Processing (IEAVTSDT) (Part 2 of 6) 


Extended Description 


Module Label Extended Description 


Module 


The dispatcher gives IEAVTSDT control as the result of a IEAVTSDX SCHSRB 
POST request from an SDUMP SRB. 

1 If the dump task has been posted to start post-dump 
processing, this means that DAE indicated that the 

dump should be suppressed. IEAVTSDT calls module IEAVTSD1 

IEAVTSD1 to obtain storage and to copy the dump header 

record into this storage. IEAVTSD1 posts IEAVTDSV and 

passes a copy of the dump header record. IEAVTDSV 

begins post-dump exit processing. IEAVTSD1 then returns 

to IEAVTSDT. 

2 If the tasks of the requested address space are 
dispatchable: 

3. IEAVTSDT calls STATUS to set the system and the tasks 
of the address space to be non-dispatchable. 


3. if a dump data set has not been selected and initialized IEAVTSDH 
for this SVC dump request, IEAVTSDT calls module 
IEAVTSDH to select and initialize the dump data set 
for this dump. IEAVTSDH writes out the SDUMP 4K 
buffer if BUFFER=YES was specified on the SDUMP 
macro. If IEAVTSDH is running on a processor with 
an active MSSF and the processor is not a part of a 
complex with a VM machine, then IEAVTSDH uses 
SVC 122 to obtain the console loop trace data. If the 
console loop trace data has not previously been read, 

IEAVTSDH calls IEAVTSDP to dump the console 
loop trace data on the dump data set. 

b. If a suspend or disabled summary dump was taken for IEAVTSDW 
a branch entry to SVC dump, IEAVTSDT calls 
module I EAVTSDW to write out the summary dump 
information on the SYS1 .DUMPxx dump data set. 


b. IEAVTSDT calls IEAVTSDB to establish a system non- 
dispatchability timer DIE to protect the system and tasks 
of this address space from being left non-dispatchable due 
to an unrecoverable error in SVC Dump. 

3 This ENQ on the SDUMP resource keeps more than IEAVTSDT SDTREQ 
one address space of a multiple address space SVC 
dump from dumping to the ssme dump dsts set at the 
same time. The QNAME used for this ENQ is 
SYSIEA01. The RNAME used for this ENQ is 
SDUMPENQ. The resident dump task in each address 
space performs only the part of the SVC dump 
processing that relates to that address space. 

An ESTAE recovery exit is established in the dump task 
for the address space when the address space is created. 

This recovery routine is located in the IEAVTSDT (label 

DTESTAE1) object module and is used as backup for the DTESTAE1 

main ESTAE. 


C. If the system is not to be quiesced, IEAVTSDT calls 
STATUS to reset the system dispatchable. IEAVTSDT 
also tells system resource management (SRM) that the 
address space can be swapped by issuing a SYSEVENT= 

OKSWAP. IEAVTSDT also allows this task to accept 
asynchronous exits. 

d. If global storage areas (such as NUC, SQA, CSA, 

LISTA storage ranges, etc.) were requested and were 
not dumped by the resident dump task previously, 

IEAVTSDT calls module IEAVTSDG. IEAVTSDG IEAVTSDG 

writes the requested global storage areas on the dump 
data set. If SVC dump set the system non-dispatch¬ 
able, IEAVTSDT sets the system dispatchable. 


IEAVTSDT establishes an ESTAE recovery exit before the 
SVC dump processing is started in the address space. This 
recovery routine is located in the IEAVAD00 (label 
SDESTAEX) CSECT end is used for all of SVC dump 
processing. 


Label 
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IEAVTSDT — Resident Dump Task Processing (IEAVTSDT) 

Extended D«cription Module Label 

e. IEAVTSDT calls IEAVTSDL for every address space IEAVTSDL 

requested. If they are available, IEAVTSDL dumps 

the default areas (authorization table, address space 
second table, linkage table, and entry tables) for all 
address spaces. If local areas were requested (for example 
SWA, LSQA, RGN), IEAVTSDL dumps these areas. For 
LIST and LISTA, IEAVTSDL obtains the address of the 
storage areas from the RTSD and writes the local storage 
areas on the dump data set. For SUBPLST, IEAVTSDL 
obtains the local subpools, requested for each address 
space, from the RTSD. For the master address space, 

IEAVTSDL only dumps the local storage areas if the 
master address space was a requested address space. 

f. If a summary dump was requested for an SVC entry to IEAVTSSE 
SVC dump, IEAVTSDT calls module IEAVTSSE to move 
the following areas to the dump data set: 

• ASID, jobname, and stepname. 

• Storage addresses specified with the SUMLIST 
parameter on the SDUMP macro. 

• Any RTM2 work area (RTM2WA) associated with the 
failing task, 2K of storage before and after every 
valid and unique address in the program status word, 
and the registers for the failure that were saved in each 
RTM2WA. 

g. IEAVTSDT calls module IEAVTSDU to determine if IEAVTSDU 
any component-related data is to be included in the 
dump. If the trace table option (TRT) is specified on the 
SDUMP macro, IEAVTSDU loads and calls the master 
trace dump exit (IEEMB879). Otherwise, processing con- IEEMB879 
tinues at step i. IEEMB879 determines if the master 
trace is active and, if it is, invokes the SDUMP output 
service to write the master trace data on the dump data 
set. (See the diagram and extended description of 
IEEMB879.) If the master trace is not active, IEEMB879 
returns to IEAVTSDU. When multiple address spaces are 
being dumped, the resident dump task in the last address 
space to be dumped is the only one that calls module 
IEAVTSDU. 


IEAVTSSE IEAVTSDP 
RTM2P 
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Extended Description Module Label 

h. If the TRT option is specified and GTF is active, IEAVTSDF 

IEAVTSDT calls IEAVTSDF to write the GTF trace 
records on the dump data set. These trace records are 
the last things written on the dump data set prior to 
the end-of-file mark. For multiple address space dumps, 
the resident dump task in the last address space to be 
dumped is the only one that calls module IEAVTSDF. 
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IEAVTSDT - Resident Dump Task Processing (IEAVTSDT) (Part 5 of 6) 
No diagram. 

Extended Description continued on next page. 
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1EAVTSDT — Resident Dump Task Processing (IEAVTSDT) (Part 6 of 6) 


Extended Description Module Label 

I. IEAVTSDT calls IEAVTSDC to clean up SVC dump IEAVTSDC 

resources when necessary. All of the tasks in the address 
space that were set non-dispatchable are reset 
dispatchabte and the system is set dispatchable. If all 
other address space dumps are complete, IEAVTSDC 
issues message IEA911E to the operator. If this SVC 
dump filled the last available dump data set, it issues 
message IEA994E or IEA994A to the operator. If 
data sets are available, it deletes operator message 
IEA994E. If tape dump data sets are being used, it issues 
message IEA984E to inform the operator to mount a 
new tape. An end-of-file is written on the dump data set. 

IEAVTSDC page-frees any modules or control blocks 
which were page-fixed by SDUMP and frees the system trace 
tables if obtained by SDUMP. It initializes the acquired areas 
for post exit processing and enqueues them on the post exit 
processing queue. IEAVTSDC also frees resources acquired 
by SVC dump. If other address space dumps are active, 

IEAVTSDC does not perform resource cleanup. IEAVTSDC 

calls IEAVTSD1 to initiate post exit processing with the IEAVTSD1 

following steps; 

• Obtains storage for the post-dump exit processing 
(PDEP) queue element. 

• Copies the dump header record saved by IEAVTSDH 
and the DAE pre-dump/post-dump parameter list 
(DSPD) into the PDEP. 

• Enqueues on the post dump exit resource (major 
name: IEASYS01, minor name: SDPOSTEX). 

• Adds the PDEP to the post-dump exit queue. 

e Posts IEAVTDSV to cause IEAVTDSV to perform IEAVTDSV 

post exit processing. See the module description for 
IEAVTDSV and IEAVTSEP for further details on post 
dump exit processing. The post exit processing 
continues after the dump has completed. 

• Dequeues from the post exit resource. 

• Returns to IEAVTSDC. 


Extended Description Module Label 

j. If no other address space dumps are active and the caller IEAVTSDT 
supplied an ECB, IEAVTSDT posts the ECB with the 

appropriate return code. 

k. IEAVTSDT releases the SDUMP resource using a 
DEQ macro. 

4 IEAVTSDT uses the branch-entry WAIT service to cause 
the dump task to logically wait for the next dump 
request. The SRB scheduled by module IEAVTSDX uses 
the branch-entry POST service to reactivate the dump 
task to process the next dump request. 
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IEAVTSDX — Schedule Dump Processing (Part 2 of 8) 


Extended Description Module Label 

Schedule dump processing (IEAVTSDX) receives control from 
an interface module (IEAVTSG L). IEAVTSG L saves the caller's 
registers and addressing mode before passing control to IEAVTSDX 
in 31 *bit addressing mode. This interface module is used to 
maintain downward compatability with branch entry SQUMP 
users running in 24-bit addressing mode. 

Schedule dump processing receives control from SVC 51 
(IEAVADOO) when the ASID, ASIDLST, TYPE=XMEM/ 

XMEME or LISTA keywords and the BRANCH-NO key¬ 
word have been specified on the SDUMP macro or when BRANCH- 
NO and SUBPLST have been specified and at least one of the 
ASIDs in the subpool list is different from the current ASID in 
control. 

Schedule dump processing also receives control as a branch 
entry when the BRANCH-YES keyword has been specified 
on the SDUMP macro. 

*| IEAVTSDX verifies the authorization of the caller. 

Callers of schedule dump processing must be in SDXAUTH 

supervisor state, key 0 and have at least one of the 
following attributes: 

e Be running disabled with a PSASUPER bit set 

• Hold any lock (including the CML lock) 

• Be in SRB mode 

• Be in cross memory mode 

• Be in EUT FRR mode 

IEAVTSDX gives callers who are not in supervisor state 
a system X'0C2' abend. IEAVTSDX gives callers who are 
not key 0 a system X'0C4' abend. IEAVTSDX gives callers 
who are not running in the proper mode a X'133' abend 
completion code. 


Extended Description 

Module 

Label 

2 IEAVTSDX establishes an FRR and initializes 
the FRR work area.IEAVTSDX then: 


SDXAUTH 


• Checks the RTCTSDPL field in the RTCT and the 
high order bit of the CVTSDBF field to see if an 
SVC DUMP is already in progress. 

• Checks the RTCTISVC field to see if a CHNGDUMP 
SET, SDUMP, NODUMP command has been 
issued, causing no SVC DUMPs to be taken. 

• Checks the RTCT and the SDUMP parameter list 
to see that a dump data set exists. 

• Checks any current RTM control blocks (RTM1WA, 
RTM2WA) to see if a caller has issued a SLIP NODUMP 
command. 

If any of the above validity checks fail, IEAVTSDX deletes 
the FRR and returns control to the caller with a return 
code of 8 in register 15. The reason for a return code of 8 is 
placed in the caller's SDWA in SDWASDRC. 
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IEAVTSDX — Schedule Dump Processing (Part 4 of 8) 

Extended Description Module Label Extended Description Module 

3 Information describing the caller's cross memory state 5 the SUBPLST keyword was specif led, IEAVTSDX calls IE AVTSPR 

is saved in the RTSD. IEAVTSDX calls the common IEAVTSPR for the SDSUBPL function. The SDSUBPL 

SDUMP parameter list routine (IEAVTSPR) for COPYPARM IEAVTSPR POSSIBLE function divides the subpool list into a global subpool list and a 

function, which does the following: local subpool list for each specified ASID. The SDSUBPL function 

• Clears the RTSD area used to hold the caller's parameter 
list. 

• Copies the user parameter list into the RTSD 

• Copies the dump header to the RTSD 

• Copies the storage list to the RTSD 

• Determines the dump options to be used from the 
combination of the CHNGDUMP options and the SDUMP 
parameter list. 

If the caller specified the DCB option, IEAVTSDX calls 
IEAVTSPR for the VALDCB function, which validates the 
DCB. The DCB must be OPEN and point to a device supported 
by SDUMP. 

If any of the above user data is invalid, the caller is abended 
with an X '233' and an appropriate reason code. 

4 If the T YPE=XMEME keyword is specified. IEAVTSOX 
locates the RTM control blocks related to the error (RTM1 

or RTM2 workarea). The PASID, SASID, and HASID at the 
time of error are stored in the RTCT ASID table. If the TYPE 9 
XMEM keyword is specified or if the TYPE s XMEME processing 
fails because no current valid RTM control blocks could be 
found, the current PASID, SASID, HASID, and CML (if a CML 
lock is held) ASIDs are moved to the RTCT ASID table. The RTCT 
ASID table has a limit of 15 unique ASIDs. Duplicate ASID 
entries are not made. 


adds new ASIDs to the RTCT ASID table, and copies the KEYLIST 
(if specified) into the RTSD. 

IEAVTSPR is always called to process the SDASIDS function. This 
function analyzes the LISTA and ASIDLST or ASID keywords. 

New ASIDs are added to the RTCT ASID table, and the LISTA 
storage ranges are copied to the RTSD. 


Label 
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IEAVTSDX — Schedule Dump Processing (Part 6 of 8) 

Extended Description Module Label 

g IEAVTSDX initializes the pre-dump parameter list ADYPRED 
(DSPD). IEAVTSDX passes the DSPD to ADYPRED, 
the DAE pre-dump processor. ADYPRED determines if 
this dump should be suppressed and builds the DAE portion 
of the dump header record. When ADYPRED returns 
control, IEAVTSDX checks the return code in register 15 
to determine if the dump should be suppressed. 

7 If the dump should be suppressed, IEAVTSDX saves 
the dump suppression status flags and the no dump 

reason code (X'OB’ in SDWASDRC) in the caller's SDWA. 

IEAVTSDX also saves the no-dump reason code in 
RTSDSDRC. (IEAVTSDT later checks this field.) 

IEAVTSDX then schedules an SRB to the DUMPSRV 
address space to post the dump task (IEAVTSDT) which 
initiates post-dump exit processing. (See the idagram for 
IEAVTSDT for more information about post-dump exit 
processing.) Once the SRB has been scheduled, 

IEAVTSDX sets the no-dump return code (X'08') in 
register 15 and returns to the caller. 

8 If a system trace was requested, a test is made to see if IEAVTSDX SDXTRACE 
the caller is in an unlocked, enabled state and did not 

specify TYPE=NOLOCAL on the SDUMP macro. If so, 

IEAVTSDX attempts to capture the trace before scheduling 
an SRB to initiate the dump. If the caller is in task mode and 
a trace table is pointed to by the RTM2 work area, this trace 
table is used. Otherwise, IEAVTSDX issues the SNAPTRC 

macro to capture the trace table. IEAVTSDX SDXSNAPT 
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IEAVTSDX — Schedule Dump Processing (Part 7 of 8) 
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IEAVTSDX — Schedule Dump Processing (Part 8 of 8) 

Extended Description Module Label 

9 If a caller has requested a disabled or suspend summary IEAVTSDX 
dump (SDATA-SUMDUMP/SUM with BRANCH=YES), 

IEAVTSDX calls module IEAVTSSD. See the M.O. diagram 
Summary Dump Processing (IEAVTSSD) for the details of IEAVTSSD 
lEAVTSSD's processing. 

10 For disabled summary dump processing, IEAVTSDX IEAVTSDX 
calls IEAVTSDB to establish a timer DIE to protect the 

real storage buffer (RSB) if IEAVTSDX holds at least 
one summary dump real storage buffer. 

11 If the caller requested a suspend summary dump SCHBDSRB 

(SDATA=SUM, SUSPEND=YES specified), 

IEAVTSDX performs no SRB scheduling at this time. The 
summary dump process has scheduled all needed SRBs. 

See the M.O. diagram Summary Dump Processing 
(IEAVTSSD) for the details of this SRB scheduling 
process. 


Extended Description Module Label 

If the caller did not request a suspend summary dump 

(SUSPEND=NO specified or defaulted to on the SDUMP 

macro), IEAVTSDX builds and schedules a global SRB. 

• If the RTCT ASID table contains more than one 
ASID from the keywords TYPE=XMEM/XMEME, 

LISTA, ASID, SUBPLST, or ASIDLST, and tha 
caller requested at least one global storage area 
(NUC, SQA, CSA, PSA, ALLPSA, TRT, SUMDUMP), 

IEAVTSDX, builds and schedules the global SRB 

to the master address space (ASID 1). 

• If the RTCT ASID table contains only one ASID, 

IEAVTSDX builds and schedules an SRB to the 
address space for which IEAVTSDX saved an ASID 
in the RTCT ASID table. The maximum number, 
of SRBs scheduled is 15. 

12 After IEAVTSDX has scheduled all of the necessary 
SRB(s), it returns control to the caller with register 
15 containing a return code. 
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IEAVTSDX - Schedule Dump SRB Processing (Part 1 of 4) 


NO 
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From the dispatcher 
as a global process SRB 

Process 



“] Establish an FRR. 


2 For a dump suppression SRB, go to 


Step 8 


3 If in masters for trace-only SRB, 

• Capture the system trace tables. 

• Schedule SRB to DUMPSRV. 

• Return to dispatcher. 


BALR 


IEAVETST 


SNAP 

TRACE 


4 If trace isn't captured yet, capture the trace. 

BALR 


5 Locate the address space and if 
necessary, 


-f 

BALR 

T 


BALR 


• Do the suspend summary dump. 


• Make the address space 
non-swappable. 




BALR 


• Make the system non-dispatchable. 




IEAVETST 


SNAP 

TRACE 


IEAVTSSV 


IRARMINT 


SYSEVENT 
do not swap 


BALR 


g Set the tasks of this address space 
non-dispatchable. 


IEAVSETS 


STATUS 
stop system 


BALR 




IEAVSETS 


STATUS 
stop tasks 


Output 


To dispatcher 


CVT 


p 


> 


RTCT 


SDWORK 


TRSN 


SRB 
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IEAVTSDX 


Schedule Dump SRB Processing (Part 2 of 4) 


Extended Description Module Label 

All SVC dump requests that specify BRANCH=YES, LISTA 
SUBPLST, ASID, ASIDLST, TYPE=XMEM, or TYPE“XMEME 
cause schedule dump SRB processing to receive control. This 
routine prepares the system and the requested address space for 
an SVC dump and starts the scheduled SVC dump process by 
posting the resident dump task (IEAVTSDT). In some cases. 

IEAVTSDX invokes suspend summary dump processing 

(IEAVTSSV). This routine can run in any address space in 

the system. IEAVTSDX also receives control for dump 

suppression processing in either the DUMPSRV or the master 

scheduler address space. If the request is for a dump that is 

to be suppressed, IEAVTSDX posts the resident dump task 

(IEAVTSDT) which starts post-dump exit processing. IEAVTSDT 


-| IEAVTSDX establishes an FRR. This FRR resides in 
module IEAVTSDR. 

2 If this SRB is for the suppression of a dump, processing 
is continued with step 8. 

3 If a suspend summary dump was requested and the 
trace table has not yet been captured, the first SRB 

to run is in the master address space. The purpose of 
sending the SRB to masters is to capture the system trace 
as soon as possible. The trace is captured using the SNAPTRC 
macro which invokes module IEAVETST. After capturing 
the trace, an SRB is scheduled to DUMPSRV and the SRB 
exits to the dispatcher. 

4 If the trace has not been captured yet, IEAVTSDX 
issues the SNAPTRC macro to capture the system 

trace. The SNAPTRC macro calls module IEAVETST. 

5 IEAVTSDX locates the requested address space in the 
RTCT ASID table and, if it is in the DUMPSRV address 

space and SUSPEND°YES was a specified option on the SDUMP 
macro, calls IEAVTSSV to perform the suspend summary dump. 
Under some conditions, IEAVTSDX needs to call 
IRARMINT and IEAVSETS. These conditions are: 

• The caller specifed that a summary dump must be 
written and the SRB is running in the master address 
space, the DUMPSRV address space, or the only 
requested address space. 


Extended Description 


Module 


• The caller requested that the CSA and SQA be dumped 
and did not specify QUIESCE s NO. 

In these cases IEAVTSDX calls IRARMINT to make the IRARMINT 

current address space non-swappable. IEAVTSDX calls 

STATUS to set the system non-dispatchable. When control 

returns from STATUS, only the exempt address spaces IEAVSETS 

in the system will be dispatchable. 

6 If this address space is one of the requested address spaces IEA VTSDX 
to be dumped (it was specified on the ASID, SUBPLST, 

ASIDLST, LISTA, TYPE=XMEM. or TYPE=XMEME key¬ 
words), IEAVTSDX calls STATUS to set all of the tasks in IEAVSETS 
this address space with a lower priority than the dump task 
non-dispatchable. This is necessary before the system can 
issue a dump of this address space. Note: the region control 
task, communications task and the dump task are never 
set non-dispatchable. 


Label 


SCHSRB 
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Schedule Dump SRB Processing (Part 3 of 4) 











LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 Method of Operation DMP-133 


IEAVTSDX - Schedule Dump SRB Processing (Part 9 of 4) 

Extended Description Module Label 

7 IEAVTSDX calls IEAVTSDB to establish the SVC Dump 
non-dispatchability timer DIE to protect the system and 

tasks of this address spsce from being left non-dispatchable 
due to an unrecoverable error in SVC Dump. 

8 IEAVTSDX uses the POST service (without an ECB) IEAVEPST 
to post the resident dump task in the current address 

space. IEAVTSDX posts IEAVTSDT to start the dump 
process or to start the post-dump exit process if the dump 
is being suppressed. IEAVTSDX sets indicators in the 
RTCT AS ID table entry for this address space to show 
that the schedule dump SRB routine received control and 
posted the resident dump task. 

9 IEAVTSDX uses SET LOCK to release the local lock 
and SETFRR to delete the FRR from the current 

FRR stack. IEAVTSDX returns control to the dispatcher 
using the return address passed as input in register 14. 
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IEAVTSEP - SVC Post Exit Processor (Part 1 of 2) 
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IEAVTSEP - SVC Post Exit Processor (Part 2 of 2) 

Extended Description Module Label 

IEAVTSEP is attached as a subtask of the Job Step Task IEAVTSEP 

(IEAVTDSV) in the DUMPSRV address space. Its function 
is to process the post-dump exits. 

1 IEAVTSEP sets up an ESTAE recovery routine to 
handle errors in IEAVTSEP and the exits. Errors 

in IEAVTSEP cause an SDUMP to be taken. The ESTAE 
routine records errors in the exits with the name of the 
exit placed in the SDWA. The ESTAE routine does not 
take a dump for exit errors; the exits must provide their 
own recovery routine for an SDUMP. 

2 IEAVTSEP cehcks the value in register 15 for a 
successful ESTAE setup. If it is equal to zero, the 

setup was successful. 

3. EXITINIT obtains the data areas required by the post¬ 
dump exits and builds the parameter list (SDEPL) 
with pointers to the data areas obtained. 

h The RUNEXITS routine calls the user exits from the IEAVTSEL 
SDUMP exit list (IEAVTSEL). Failures in an exit 
routine are recorded and control passes to the next 
exit in the list. The DAE post-dump exit routine, 

ADYPSTD, is the last exit to be called. 

C. The CLEANUP routine executes only once. It 
cleans up all of the obtained storage and terminates. 

It frees storage for the exit work area, exit interface 
area, and the copy of the dump header record. 

d. IEAVTSEP deletes the ESTAE. 

3 If the ESTAE could not be established, the input 
storage is freed. 
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XEAVTSRB - NODULE DESCRIPTION 


DESCRIPTIVE NANE: SVC Dump SRB Routine 
FUNCTION: 

IEAVTSRB is the SRB scheduled by IEAVTSDX and by IEAVTSSD 
(for Suspend summary dump requests). It has three mutually 
exclusive purposes: 

The first purpose is to initiate the dumping process. 

The SRB may call IEAVTSSV to perform Suspend summary 
dump processing and then issue SNAPTRC if the system 
trace tables have not been captured yet for this dump. 

The SRB will set the system and address space environment 
so that a dump can be taken by setting the system and/or 
tasks of the address space non-dispatchable. The SRB will 
then activate the resident dump task to dump storage in 
this address space. 

The second purpose is to post the dump task to start off 
post exit processing for a requested dump which has been 
suppressed by Dump Analysis and Elimination (DAE). 

The third purpose is to perform as a special trace SRB 
in masters address space. This occurs when the caller 
of SVC DUMP is requesting a Suspend summary dump but 
is not in an enabled unlocked state and therefore 
the system trace tables could not be captured earlier. 

The SRB issues the SNAPTRC macro to get a snapshot of 
the system trace tables and then schedules an SRB to the 
DUMPSRV address space to initiate the dumping process. 

ENTRY POINT: IEAVTSRB 

PURPOSE: 

IEAVTSRB is the SRB scheduled by IEAVTSDX and by IEAVTSSD 
(for Suspend summary disnp requests). It has three mutually 
exclusive purposes: 

The first purpose is to initiate the dumping process. 

The SRB may call IEAVTSSV to perform Suspend summary 
dump processing and then issue SNAPTRC if the system 
trace tables have not been captured yet for this dump. 

The SRB will set the system and address space environment 
so that a dump can be taken by setting the system and/or 
tasks of the address space non-dispatchable. The SRB will 
then activate the resident dump task. 

The second purpose is to post the dump task to start off 
post exit processing for a requested dump which has been 
suppressed by the dump suppression component. 

The third purpose is to perform as a special trace SRB. 
The SRB issues the SNAPTRC macro to get a snapshot of the 
system trace tables and then schedules an SRB to DUMPSRV. 

LINKAGE: LPSN 

CALLERS: None 

INPUT: SVC Dump control blocks 
OUTPUT: 

The system and/or address space has been set 
non-dispatchable and the dump task has been posted. 

ENTRY POINT: SRBFRR2 

PURPOSE: Recover from a failure in the SVC Dump SRB Routine. 
LINKAGE: LPSH 
CALLERS: None 
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IEAVTSRB - NODULE DESCRIPTION (Continued) 


INPUT: 

SVC Dump control blocks 
FRR 6 word work area 

OUTPUT: 

Request RTM to record. 

Request RTM to release the local lock. 

Percolate to SRBFRR1. 

EXIT NORMAL: Return to IEAVTRTS. 

ENTRY POINTS SRBFRR1 

PURPOSE: Recover from a failure in the SVC Dump SRB Routine. 
LINKAGE: LPSN 
CALLERS: None 
INPUT: 

SVC Dump control blocks 
FRR 6 word work area 

OUTPUT: 

The system and/or address space has been set 
dispatchable and the user has been posted. 

Retry, if allowed, requested. 

EXIT NORMAL: Return to IEAVTRTS. 

EXTERNAL REFERENCES: 

ROUTINES: 

IEAVPT00 - Post routine* awaken dump task and 
awaken caller. 

IEAVESRT - Reset the stopped SDUMP caller 
IEAVTSDB - Establish timer dies to protect critical 
system resources (i.e. the real storage 
buffer and system dispatchability). 

IEAVTSSV - Move Suspend summary dump data to 

the SVC Dump virtual storage buffer 
IARXPLCK - Obtain RSM serialization 
IARXPRSB - Free real storage frames and free 
RSM serialization. 

CONTROL BLOCKS: 

COMMON LIBRARY 


Common name 

Macro ID 

Usage 

Function 

ASCB 

IHAASCB 

read 

Checks if the address space 
has failed and whether the 




dump task is active. 

ASVT 

IHAASVT 

read 

Checks if SVC Dump caller is 
still active before posting 
the callers ECB. 

ASXB 

IHAASXB 

read 

Obtains address of top TCB 


in order to set all the 
tasks non-dispatchable/ 
dispatchable. 


CVT 

CVT 

read and 
write 

Unlocks the 4K SQA buffer, 
and uses the CVTBRET. 

DSPD 

ADYDSPD 

read 

(see ADYDSTAT). 

DSTAT 

ADYDSTAT 

read 

Puts DAE suppression flags 
into VRA in the FRR. 

FRRS 

IHAFRRS 

read and 
write 

Adds and deletes two FRRs. 

OUCH 

IRAOUCB 

read 

Checks if DUMPSRV is going 
through swapout processing 


LY28-1670-1 (c) Copyright IBM Corp. 1987, 1989 


Method of Operation DMP-137 




"Restricted Materials of IBM" 
Licensed Materials - Property of IBM 


XEAVTSRB - MODULE DESCRIPTION {Continued) 


PSA 

IHAPSA 

read 

PVT 

IHAPVT 

read 

RTCT 

IHARTCT 

read and 



write 


RTSD 

IHARTSD 

read and 
write 

SDDAT 

IHASDDAT 

read and 
write 

SDDIE 

IHASDDIE 

read and 
write 

SDDSQ 

IHASDDSQ 

write 

SDMOD 

IHASDM0D 

read 

SDWA 

IHASDMA 

read and 
write 

SDHQRK 

IHASDWRK 

read and 
write 

SMWK 

IHASMWK 

read and 
write 


. SRB 

IHASRB 

read 

SVT 

IHASVT 

read 

TCB 

IKJTCB 

read 

TQE 

IHATQE 

read 

TRSN 

IHATRSN 

read and 
write 


Obtains the current address 
space and adds/deletes FRRs. 
Obtains addresses of RSM 
routines. 

Obtains address of DUMPSRVs 
ASCB, checks and updates 
the SVC Dump ASID table> 
checks and updates SVC Dumps 
Information/Flags section, 
checks the SDUMP partn list 
via RTCTSDPL and unlocks 
SVC Dump by clearing it in 
the FRR. 

Sets and checks internal 
flags and uses save areas 
internally as well as for 
calling services 
Obtains addresses of 
SVC Dump control blocks and 
clears SDDSDPL in the FRR. 
Fills in the DIE control, 
block prior to calling 
IEAVTSDB to establish the 
DIE. 

Sets the serialization flag 
off to release the current 
SDDSQ entry in the FRR. 

Obtains starting and ending 
addresses of SVC Dump modules. 
Obtains the work area address 
and checks if retry is allowed 
and fills in diagnostic 
information to RECORD. 

Checks if this SRB was entered 
as a dump suppression SRB and 
sets the SRB in error flag 
(in SDRSN) in the FRR. 
Cleans-up RSB indicators and 
counters in the FRR, resets 
the Suspended SVC Dump caller 
in the FRR, checks if Suspend 
summary dump is active or in 
error, checks and sets off 
the flag indicating this is 
a special trace SRB, obtains 
the ASCB address of the 
local lock being held by 
the stopped unit of work, 
and obtains the address of 
the initialized SRB to 
DliMPSRV for Suspend summary 

(required by IHASDDIE). 
(required by IHASMWK). 

(required by IHASDDIE). 

Fills in to request a snap 
trace, fills in to request 
SNAPTRC to free the system 
trace tables in the FRR, 
and cleans-up the trace 
indicators. 


SERIALIZATIONS Entered with the SVC Dump serialization. 
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XEAVTSRB - NODULE OPERATION 


First* this routine will establish recovery. 

If this is a special trace SRB to masters (see notes)* 
it issues the SNAPTRC macro to get a snapshot of the system 
trace tables. If an SRB can be scheduled to DUMPSRV* IEAVTSRB 
schedules an SRB to DUMPSRV to initiate the dumping process. 

If this SRB was scheduled to initiate the dumping process 
or was scheduled to do special trace processing but could not 
schedule the SRB to DUMPSRV* the following processing is done. 
If a Suspend summary dump is requested and this SRB is the 
first global SRB and is executing in the DUMPSRV address 
space* the SRB obtains the local lock and calls IEAVTSSV 
to complete the Suspend summary dump. If the system trace 
tables have not been captured yet* the SRB releases the 
local lock if held and issues the SNAPTRC macro which will 
capture the system trace tables. IEAVTSRB then obtains 
the local lock if not already held. If the dump task in 
this address space is dispatchable and the system should be 
set non-dispatchable* the SRB issues SYSEVENT to make this 
address space non-swappable* sets TCBFX to stop IRB scheduling* 
and calls STATUS to set the system non-dispatchable. 

The SRB calls IEAVTSDB to establish the Timer DIE which 
protects the system/tasks from being left non-dispatchable. 

The SRB calls STATUS to set the tasks (except Commtask 
and RCT) non-dispatchable. If the dump task in masters is 
non-dispatchable* the SRB calls STATUS to set it dispatchable. 
The SRB then calls IEAVPTOO to post the resident disnp task 
and releases the local local. 

If this SRB was scheduled to initiate post exit processing 
for a requested dump which has been suppressed by DAE* the 
SRB obtains the local lock* posts the resident (masters or 
DUMPSRVs) dump task* and then releases the local lock. 

IEAVTSRB deletes its recovery and returns to the dispatcher. 
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XEAVTSRB - DIAGNOSTIC AIDS 


ENTRY POINT NAMES: IEAVTSRB 
SRBFRR2 
SRBFRR1 


MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 

RETURN CODES: 

ENTRY POINT IEAVTSRB: None 
ENTRY POINT SRBFRR2: 

EXIT NORMAL: 

SDHARCDE = 0 (percolate) 

ENTRY POINT SRBFRR1: 

EXIT NORMAL: 

SDWARCDE = 0 (percolate) if SDMACLUP is on 

or no retry address (FRR6WRT~0) 
4 (retry) otherwise 


REGISTER CONTENTS ON ENTRY: 

ENTRY POINT IEAVTSRB: 

Reg 0 - address of SRB 

Reg 1 - contents of SRBPARM field 

Reg 2-13 - irrelevant 

Reg 14 - return address 

Reg 15 - entry point 

ENTRY POINT SRBFRR2: 

Reg 0 - address of 200 byte FRR work area 

Reg 1 - address of SDWA 

Reg 2-13 - irrelevant 

Reg 14 - return address 

Reg 15 - entry point 

ENTRY POINT SRBFRR1: 

Reg 0 - address of 200 byte FRR work area 

Reg 1 - address of SDWA 

Reg 2-13 - irrelevant 

Reg 14 - return address 

Reg 15 - entry point 


REGISTER CONTENTS ON EXIT: 

ENTRY POINT IEAVTSRB: 


Reg 0-13 - irrelevant 
Reg 14 - return address 
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IEAVTSRB - DIAGNOSTIC AIDS 


Reg 15 - irrelevant 

ENTRY POINT SRBFRR2: 

EXIT NORMAL: 

Reg 0-13 - irrelevant 
Reg 14 - return address 
Reg 15 - irrelevant 

ENTRY POINT SRBFRR1: 

EXIT NORMAL: 

Reg 0-13 - irrelevant 
Reg 14 - return address 
Reg 15 - irrelevant 


(Continued) 
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XEAVTSRB - SVC Dump SRB Routine 


STEP 01 


XEAVTSRB 


XHAPSA 


IPSACSTK 


XHASNWK 


SMWKSRBS SMWKSRBTI 


XHAASCB 


| ASCBASZD 


v IEAVTSRB is the SRB scheduled by IEAVTSDX 
> and by IEAVTSSD (for Suspend summary dump 
f requests). It has three mutually exclusive 
IB purposes: The first purpose is to initiate 
the dumping process. The SRB may call 
IEAVTSSV to perform Suspend summary dump 
processing and then issue SNAPTRC if the 
system trace tables have not been captured 
yet for this dump. The SRB will set the 
system and address space environment so 
that a dump can be taken by setting the 
system and/or tasks of the address space 
non-dispatchable. The SRB will then 
activate the resident dump task to dump 
storage in this address space. The second 
purpose is to post the dump task to start 
off post exit processing for a requested 
dump which has been suppressed by Dump 
Analysis and Elimination (DAE). The third 
purpose is to perform as a special trace 
SRB in masters address space. This occurs 
when the caller of SVC DUMP is requesting 
a Suspend summary dump but is not in an 
enabled unlocked state and therefore the 
system trace tables could not be captured 
earlier. The SRB issues the SNAPTRC macro 
to get a snapshot of the system trace 
tables and then schedules an SRB to the 
DUMPSRV address space to initiate the 
dumping process. 

J \ 01 Establishes two recovery 
1 / -exits (SRBFRR1 and SRBFRR2). 


02 If this is a special trace 
— 1 SR B, performs the SNAPTRACE 
function and schedules the 
SRB to DUMPSRV* 

A. Calls SNAP to obtain the SNAP TRACE. 


->IHAPSA 



\IHARTSD 

IrtsdskipI 
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IEAVTSRB - SVC Dump SRB Routine 


STEP 02B 


IHAASCB 


ASCBDUMP 


IHARTSD 


RTSDSKIP 


IHARTCT 


RTCTSDMA RTCTSDAS : 
RTCTASCB : 


IHAPSA 


PSAAOLD 


IHASDWRK 


SOHSDRC 


IHASMWK 


SMKKSRBA 


IHAASCB 


ASCBASID 


IHASDUMP 


SDUSPEND 


IHASMWK 


SMWKSPER 


IHARTCT 


RTCTSDMA RTCTASCB 


IHAPSA 


PSAAOLD 


IHARTSD 


RTSDSRBS 


IHARTSD 

Irtsddotr 


J\ 

1 / 


-> 


> 


■> 


B. If DUMPSRV is okay, schedules SRB to 
DUMPSRV for Suspend summary dump and 
skips the rest of the code to the end of 
this module where it frees the FRRs and 
exits. 


03 


Zf a Suspend summary dump is 
requested? calls IEAVTSSV to 
finish the suspend summary 
dump. 


A. Obtains the local lock. 

B. Calls IEAVTSSV to finish the Suspend 
summary dump processing started by 
IEAVTSSD. 


IEAVTSSV 


04 


If a system trace is 
required? calls SNAP to 
obtain the SNAP TRACE. 


A. Frees the local lock if held. 


B. Calls SNAP to obtain the SNAP TRACE. 


-KIHARTCT 
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IEAVTSRB - SVC Dump SRB Routine 


STEP 05 


SNAP: 11 


Obtains the local lock if 
not held. 


XHASDWRK 


IHAASCB 
ASCBASID ASCBDUMP 

XKJTCB 

TCBFLGS5 

IHARTCT 

RTCTSDNA RTCTSDMA 
RTCTASCB 

IHAPSA 


IHASDUNP 


If not dump suppression and 
the dump task in this 
address space is 
non-dispatchable, sets the 
tasks and the system 
non-dispatchable as 
requested. 


SDUSPEND 


XKJTCB 


TCBFLGS4 


IHARTCT 

RTCTSDRW 

IHASDUNP 

SDUQUIET 

IHARTSD 


RTSDSRBS 


A. If this is the first global SRB and if 
it is running in Master or DUMPSRV or it 
is a one address space dump without 
Suspend and if a summary dump is to be 
written or QUIESCE was requested> sets 
the address space non-swappable via 
SYSEVENT y stops asynchronous interrupts 
to the dump task and calls STATUS to set 
the system non-dispatchable. 



\IHARTCT 

/.- 

RTCTSDNS 

RTCTSDFX 

\IKJTCB 

ItcbfxI 
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XEAVTSRB - SVC Dump SRB Routine 


STEP 06B 


XHASDDXE 


SDDIE SDDIESER 


IHARTCT 


RTCTSDND 

: 

IHARTSD 

i 

RTSDSRBS 

i 


XHASDDXE 


SDDIESYS SDDIETSK 
SDDIEAND 


XKJTCB 


TCBNTC TCBTID 


XHAASCB 


ASCBDUMP 


XHAASXB 


ASXBFTCB 


XKJTCB 


TCBLTC 


XHAASCB 


ASCBASID 


XHARTCT 


RTCTSDAN 


XHAASCB 


ASCBDUMP 


XHAASCB 


ASCBDUMP 


XKJTCB 


TCBRBP 


V 


J\ 

1 / 


J\ 

V 


V 


B. If not already established) calls 
IEAVTSDB to establish the SVC Dump 
non-dispatchability Timer DIE to protect 
the system and tasks from being left 
non-dispatchable due to an unrecoverable 
error in SVC Dump* 



J \XHASDDIE 


SDDIEFNC 

SDDIECLR 

SDDIETIM 
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>11 Sets up for the SNAPTRC 
-V I — 1 macro invocation and then 
snap I issues the macro. 


XHASMWK 


SMWKSRBT SMWKASLL 


IHARTSO 


RTSDSRBS 


ZHASDDAT 


SDDTRSN 


ZHATRSN 


TRSNLVLN TRSNSNAP 


ZHAASCB 


, ASCBASID 


ZHASMMK 


SMWKSRBT 


ZHATRSN 


TRSNTTCH TRSNLEN 



>12 Initializes SDWORK fields 
1 - 1 for SNAPTRC. 


13 Zssues SNAPTRC macro. 


141 Saves trace information if 
— t SNAPTRC successful. 




15 Sets partial dump indicator 
— 1 if SNAPTRC failed. 



KIHARTSD 

\ / \ - 1 

RTSODOTR 

KZHATRSN 

i / \ - 1 

TRSNID 

TRSNBLVL 

TRSNLLID 

TRSNTYPE 

TRSNASID 


\ZHASDWRK 

IsDTRACRcl 


\ZHASDWRK 

/■- 

SDTTCH 

SDTRCLEN 

\ZHATRSN 


\ZHARTSD 

IRTSODOTRI 


\ZHASDRSN 

IsDRBRTRcl 
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IEAVTSRB - SVC Dump SRB Routine STEP 16 






MHASDWA 

/.- 

SDWASR03 

SDWASR09 
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IEAVTSRB - SVC Dump SRB Routine 


STEP 22A 


IHARTCT 


IRTCTSDND 


A. If SVC Dump set the system 

non-dispatchable> sets the system 
dispatchable> allows asynchronous 
interrupts in the dump task> and 
notifies SRM its okay to swap this 
address space. 


'MHASDDIE 


MHARTCT 

|/f- 

RTCTSDND 


ASCBDUMP 


STATUS 


IHARTCT 


MHASDDIE 


RTCTSDNS RTCTSDFX 


IHAASCB 


SDDIEND 


\IKJTCB 


IHASDRSB 


SMWKFRHD 


IHASDUMP 


B. If real storage frames are held or this 
is a Suspend summary dump request 
running in the DUMPSRV address space> 
page fixes IEAVTSRB and obtains the CPU 
lock. 


MHARTCT 


RTCTSDNS 

RTCTSDFX 


SDUSPEND 


XHASMWK 


SMWKRSET SMWKSTOC 


IHASDRSB 


SMWKFRHD 


IHASNWK 


SMWKRSBL 


IHASDRSB 


.SMWKL0K2 


C. If real storage frames are held* cleans 
up the RSB. 


D. Lock up RSM. 

(!=!)[ 


IARXPLCK 


MHASDRSB 


SMWKFCDE 


IHASDRSB 


iSMKQCFRHD 


IHASNWK 


SMWKRSM 


E. Free all frames. 

/'—'\[— 
\i—1/ 


IARXPRSB 


\IHASMWK 


SMWKNFAV 

SMWKRSIX 

SMWKFRUS 


MHASDRSB 


XHASDRSB 


SMWKFALL 


XHASDRSB 


SMWKFCDE 

SMWKFRHD 


\XHASDRSB 


F. Free RSM locks. 



SMWKFCDE 
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XEAVTSRB - SVC Dump SRB Routine 


XHASDUHR 


SMWKRSET SMWKSTOC 
SMWKSROA SMWKSRHA 
SMWKREND 


IHARTCT 


RTCTSDMA RTCTASCB 


IHAPSA 


PSAAOLD 


XHAASCB 


ASCBASID 


IHARTCT 


RTCTSDNA 


IHARTCT 


RTCTSDAS 


XHAASCB 


ASCBASID 


IHARTCT 


RTCTSDAN 


XKJTCB 


TCBNTC TCBTID 
XHAASCB 
ASCBDUMP 
XHAASXB 

ASXBFTCB ^ 

XKJTCB 

TCBLTC _ i 

IHATRSN 

Itrsnttch I 


->I 6. For Suspend summary dump requests 


H. Releases the CPU lock if held and page 
frees IEAVTSRB if fixed. 

I. Harks all of the requested address space 
dumps complete in order to cause a total 
cleanup. 


231 Zf this is not the first or 
— 1 only SRB* marks the current 
address space dump complete. 


24 Sets the tasks in this 
— 1 address space dispatchable. 


-> 25 Frees system trace tables 
1 — 1 acquired for SVC Dump. 

A. Releases the local lock. 


STEP 22G 
—KIHASMWK 


SDUSPEND ; 

running in the DUMPSRV address space> - 

resets fhe suspended SVC Dump caller. 

-,/.-. 

SMWKSRWA 

IHASMWK i 

^ 1 *4 ' 

orimoKnl 




\IHARTCT 


RTCTSDDO 


MHARTCT 

l / |-1 

RTCTSDAN 
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IEAVTSRB - SVC Dump SRB Routine 


STEP 25B 


IHASDDAT 


IHATRSN 

TRSNFREE 

IHARTCT 


RTCTSDDO 


IHARTCT 


IRTCTSDNA 


IHARTCT 

RTCTSDNA 

IHASDWRK 


-> B. Calls the SNAPTRC routine. 
1/ 


-> C. Obtains the local lock. 

I\ 

1/ 


-> 261 If this address space is the 
1 — 1 last active one of this dump 
request , releases SVC Dump 
serialization. 



MHATRSN 

/1-1 

TRSN 

TRSNTYPE 

MHASDWRK 

SDTTCH 


MHASDDSQ 

IsDDSQCS I 


SDDSQCUR 

IHASDUMP 

ISDUECB SDUCASID 
SDUTPFRC 


IHAASVT 


ASVTAVAL 


IHARTCT 


RTCTSDNA RTCTSDMA 
RTCTASCB 


-> A. If the caller specified an ECB, posts 
J \ the callers ECB* 

/ 



ASVTENTY 
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XEAVTSRB - SVC Dump SRB Routine 


STEP 26B 


XHASDWRK 

SDDSQCUR 
XHARTCT 
RTCTSDI RTCTSDF 
CVT 

iCVTSDBF 


J\ 

1 / 


-K 

29 > 

- \ / 

FILLSDWA 
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IEAVTSSD — Summary Dump Processing (Part 1 of 8) 


Input 


From schedule dump 
(IEAVTSDX) via BALR 

Process 


CVT 


RTCT 


SMWK 


Registers 
to save 



t Set the summary dump 
environment. 


• Initialize the recovery 
and work area fields. 


• Obtain the RSM 

serialization. 


— If unable to obtain 
RSM serialization, 
return to caller. 


— Otherwise, continue. 


Output 


IARXPLCK 
RSM lock 
routine 




To schedule 
dump (IEAVTSDX) 
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IEAVT5SD — Summary Dump Processing (Part 2 of 8) 

Extended Description Module Label 

Summary dump processing provides a synchronous dump of IEAVTSSD 
volatile system data areas. Other system activity or the 
invoking recovery routine would change these areas before 
asynchronous SVC dump processing dumped them and they 
would not reflect the state of the system or the failing com- 
Ronent at the time of the error. The volatile data areas sum¬ 
marize the state of the $y$tem. 

All SVC dump invocations where both the BRANCH^YES 
and SDATA=SUMDUMP have been specified use summary 
dump processing. 

IEAVTSSD supports two types of summary dumps, the dis¬ 
abled summary dump and the suspend summary dump. Dis¬ 
abled summary dump (SDATA=SUMDUMP, BRANCH=YES f 
SUSPEND-NO) uses a real storage buffer to save the volatile 
system data. Only paged-in data can be saved in this buffer. 

Disabled summary dump is meant to be used by components 
whose error related data is volatile because of other system 
activity. Since these callers have some type of global seriali¬ 
zation, they require that the real storage buffer be used. 

Suspend summary dump (SDATA=SUMDUMP, BRANCH= 

YES, SUSPEND=YES) uses a virtual storage buffer in the 
DUMPSRV address space to save the volatile system data. 

Both paged-in and paged-out data can be saved in this 
buffer. Suspend summary dump is meant to be used by com¬ 
ponents whose error data is volatile because it will be changed 
by the calling recovery routine. Since these callers have some 
type of local serialization, they require that a virtual storage 
buffer be used. (The IEAVTSSV diagram documents in 
detail the areas dumped for a suspend summary dump.) 

Summary dump processing can be entered in cross memory 
mode. IEAVTSSD uses the addressing mode of the 
caller when referencing global system areas (such as the PSA 
and LCCA). IEAVTSSD simulates the addressing mode at 
the time the status was saved when dumping the data 
related to the saved system status (such as the SDWA and 
IHSA). 


Extended Description Module 

1 IEAVTSSD establishes an FRR to provide recovery IEAVTSSD 
for the disabled and suspend summary dump processing 
located in this module. See recovery processing at the end 
of this module's extended description for more details. 

IEAVTSSD saves the caller's registers and initializes the sum- IEAVTSSD 

mary dump work area (SMWK). 

If IEAVTSDX did not obtain serialization for the real storage 
buffer (RSB) before, IEAVTSSD obtains the CPU lock to 
provide disablement and then calls IARXPLCK to obtain 
RSM serialization for the RSB. If IARXPLCK cannot 
obtain the RSM serialization, a partial dump reason flag 
is set in RTSDSRSN (mapped by SDRSN) and control 
returns to IEAVTSDX. 


Label 

SUMFRR 

SUMINIT 

SUMLOCK 
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IEAVTSSD - Summary Dump Processing (Part 4 of 


Extended Description 


Module 


2 IEAVTSSD calls RSM module IARXPRSB to obtain 
the real storage buffer. Upon return from 
IARXPRSB, the SDRSB contains the number of real 
storage frames obtained and a table containing the real 
storage address of each frame. If IARXPRSB could not 
obtain any real storage frames, IEAVTSSD calls 
IARXPRSB to release the RSM serialization, releases the 
CPU lock, deletes the FRR and sets a partial dump reason 
flag in SDRSN (RTSDSRSN). 


IEAVTSSD 


IARXPRSB 


8 ) 

Label 

TOPSEG 
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IEAVTSSD - Summary Dump Processing (Part 6 of 8) 


Extended Description Module Label 

3 If space should run out in the real storage buffer, IEAVTSSD TOPSEG 

summary dump sets a reason flag in RTSDSRSN 
mapped by IHASDRSN. 

Both disabled and suspend dump requests cause data to 
be moved to the allocated real storage buffer. For disabled 
summary dump requests, IEAVTSSD moves the following 
areas to the real storage buffer in the order shown. 

• Areas described by the SUM LIST or SUMLISTA 
storage list addresses (if the SUM LIST or SUMLISTA, 
keywords were specified on the SDUMP request! 

• The PSA, LCCA and PCCA for each functioning 
processor. 

o The current PCLINK stack elements (pointed to by 
PSASEL). 

• The relevant interrupt handler save area (IHSA), its 
associated XSB, and the PCLINK stack elements 
pointed to by this XSB. 

• The super FRR stack and the current system diag¬ 
nostic work area (FRRS, SDWA). 

• 4K of storage around non-duplicated areas pointed to 
by the registers saved in the current SDWA and 

IHSA. IEAVTSSD uses the addressability in effect when 
the status was last saved in the SDWA and IHSA. If 
the primary and secondary ASIDs are different, both 
will be used to dump the storage related to the saved 
register values. 

• The global,, processor, and relevant local work 
save area vector tables. 

• The global, processor, and relevant local work save 
areas. 

• 4K of storage around the instruction counter values 
of the external old, program check old, I/O old, 
and SVC old PSW values saved in the LCCA and 
PSA for all processors. IEAVTSSD uses the caller's 
primary ASID to reference these values. 

• 8K of storage around the PSW and general purpose 
registers from both primary and secondary address 
spaces when the caller supplies a PSWREGS area. 


Extended Description 


Module 


Label 


For suspend summary dump requests, IEAVTSSD 
moves the following areas to the real storage buffer 
in the order shown: 

• The PSA, PCCA, and LCCA for all active processors. 

• The relevant interrupt handler save area (IHSA), its 
associated XSB, and the PCLINK stack elements 
pointed to by this XSB. 

IEAVTSSD calls IEAVTSSM to physically move the data IEAVTSSD 
to be dumped to reai storage buffer frames. 

4 After moving the requested data areas to the real 
storage buffer, IEAVTSSD calls RSM to free any 
unused portions of the real storage buffer. If the RSM IARXPRSB 

serialization was obtained in IEAVTSSD, IEAVTSSD 
calls module IARXPRSB to release it. IEAVTSSD 
releases the CPU lock. 

Disabled summary dump processing continues at step 
6. Suspend summary dump processing continues with 
step 5. 
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IEAVTSSD — Summary Dump Processing (Part 7 of 8) 


Input 


Process 
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IEAVTSSD — Summary Dump Processing (Part 8 of 8) 


Extended Description Module Label 

5 Only suspend summary dump requests execute this IEAVTSSD SSDSPND 
step. Suspend summary dump, running enabled as an 
SR8 routine in the dumping service's address space 
(DUMPSRV), moves pageable volatile system data to a 
virtual storage buffer located in the DUMPSRV address 
space. IEAVTSSD requires the new unit of work in order 
to address the virtual storage buffer and to handle page- 
faults when referencing the data being dumped. 

IEAVTSSD calls IEAVTSDB to establish a timer DIE to 
protect the unit of work that is stopped during suspend 
summary dump processing. The timer DIE resets the 
stopped unit of work if it detects that SVC Dump has 
halted processing. 

IEAVTSSD initializes the SR6 block passed to this module 
by IEAVTSDX. IEAVTSSD obtains the LOCAL lock (if a 
local lock is not already held) in order to make the 
current home address space non-swappable.‘ IEAVTSSD 
obtains the SALLOC lock to satisfy the interface re¬ 
quirement for serializing the stop (IEAVSUSQ). Schedule 
dump processing sets the SRB to run as a global SRB in 
the DUMPSRV address space. Details of the SRB process 
are shown in the Schedule Dump SRB Processing 
(IEAVTSDX) diagram. 

IEAVTSSD saves the current register values and builds 

a model PSW in the SMWK. The system restores these 

values when summary dump processing resumes. IEAVTSSD 

calls IEAVSUSQ to suspend the current unit of work IEAVSUSQ 

(SRB or TCB). On return from IEAVSUSQ, IEAVTSSD 

saves the address of the suspended unit of work in the 

SMWK, releases the SALLOC lock, and gives control to 

the dispatcher (at entry point IEAVDSPC). 


Extended Description 


Module 


Label 


6 Control passes to this step at the completion of both TOPSEG 

suspend and disabled summary dump processing. 

IEAVTSSD deletes the FRR recovery routine from the 
current FRR stack, using the SETFRR macro. 

Recovery Processing: 

RTM gives an FRR routine control if errors occur during IEAVTSSD SUMFRR 
summary dump processing. If RTM allows, this FRR will 
retry. The FRR always records the pertinent diagnostic 
data saved in the SDWA and the SDWA VRA for this error 
to SYS1.LOGREC. In cases where retry cannot be per¬ 
formed, this FRR releases all summary dump resources 
that it holds. 

When RSM serialization is held, an RSM FRR 
remains on the FRR stack. If the RSM FRR 
ever receives control, the RSB is cleaned up 
and the RSM serialization freed. 
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IEAVTSSV — Suspend Summary Dump Processing (Part 1 of 4) 

IEAVTSDX (SCHSRB) 
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IEAVTSSV — Suspend Summary Dump Processing (Part 2 of 4) 


Extended Description Module Label 

Suspend summary dump processing provides a synchronous 
summary type dump of volatile system areas. Suspend 
summary dump moves this volatile system data to a virtual 
storage buffer located in the dumping services address space 
(DUMPSRV). IEAVTSSV receives control enabled, in SRB 
mode, and holding the LOCAL lock of the DUMPSRV ad¬ 
dress space. IEAVTSSV holds the LOCAL lock so that the 
DUMPSRV address space will not be swapped out during 
suspend summary dump processing. Being enabled allows 
page-fault processing to continue, this means that volatile 
data that is paged-out when the dump is taken can still be 
dumped. Accessing this data is important to solving a soft¬ 
ware problem. This volatile data mu$t be saved now because 
the recovery routines of the component encountering the 
error will clean up this data before the regular, scheduled 
SVC dump could be completed. All SVC dump requests 
specifying the SDATA=SUMDUMP, BRANCH=YES, and 
SUSPEND s YES keywords use suspend summary dump. 

Subpool 229 of the dumping services address space 
(DUMPSRV) contains the suspend summary dump's virtual 
storage buffer. A field in the SMEW control block 
(SMEWVBST) points to the buffer. 

1 The schedule dump SRB routine (IEAVTSDX) TOPSEG 

gives suspend summary dump control enabled, in 
SRB mode, and with the LOCAL lock held. IEAVTSSV 
saves the caller's registers in the provided register save 
area and establishes an FRR to cover the suspend summary 

dump process. This FRR is located in module IEAVTSSV SSVFRR 

(SSVFRR label). 


Extended Description Module Label 

2 IEAVTSSV moves the following areas to the virtual TOPSEG 

storage buffer in the order shown. (If space runs out 

in the virtual storage buffer, suspend summary dump sets 

a flag in the SDUMP work area (SDWSDRSN mapped by 

SDRSN). A partial dump message will result (IEA911E).) 

• Storage defined by the address ranges specified using SSVSMLST 

the SUM LIST keyword. 

e Storage defined by the address ranges specified using SSVSMLTA 

the SUMLSTA keyword. 

• The SVC dump caller's home address space ASCB. TOPSEG 

• The suspended unit of work: 

— For TCB mode callers this is the TCB, RB, and XSB. SSVTCB 

— For SRB mode callers this is the SSRB and XSB. SSVSRB 

• The PC LINK stack associated with the suspended unit 
of work. 

• The error SDWA. SSVSDWA 

• For task mode callers the RTM2WAs associated with SSVTCB 

the suspended TCB. 

• The SDUMP caller's register save area. TOPSEG 

• 4K of storage around the unique register values saved SSVSAREA 

in the SDWA and the caller's register save area. 

• 4K of storage around the PSWs saved in the SDWA. 

• 8K of storage around the PSW and general purpose 
registers from both primary and secondary address 
spaces when the caller supplies a PSWREGS area. 
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IEAVTSSV — Suspend Summary Dump Processing (Part 4 of 4) 


Extended Description Module 

3 IEAVTSSV obtains the address of the suspended unit IEAVTSSV 

of work and of the caller's ASCB from the SMWK. 

IEAVTSSV passes these values as input to IEAVRSTD. 

IEAVRSTD RESETs the stopped process in module IEAVRSTD 

IEAVTSSD. Suspend summary dump processing is now 

complete so the caller's recovery routines can now 

modify control blocks and data areas without damaging 

the contents of the dump. 


4 I EAVTSSV issues a SETFRR to delete the I EAVTSSV I EAVTSSV 

PRR entry from the current FRR stack. IEAVTSSV 
restores all the saved registers and returns control to 
schedule dump SRB processing (IEAVTSDX). 


Label 

TOPSEG 


TOPSEG 
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IECDAFMT — Data Management Formatter Mainline (Part 1 of 4) 
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Entered as a TCB exit from AMDPRDMP or from SNAP/ABDUMP 
to format the data management control blocks 



Output 
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IECDAFMT — Data Management Formatter Mainline (Part 2 of <♦) 

Extended Description Module Label 

This routine operates as a TCB exit for the service aid 
AMDPRDMP or is directly invoked by SNAP/ABDUMP. 

This routine locates the data management control blocks 
to be formatted and invokes the appropriate formatter. 

1 IECDAFMT establishes an ESTAE that will retry at IECDAFMT ESTAERIN 
a designated retry address for expected errors and 
will print an ABEND message for unexpected errors. 

For invocations by SNAP/ABDUMP an error is expected 
whenever a storage reference is made. If the error is not 
expected, IECDAFMT places an abend message in the buf¬ 
fer and attempts to retry in the mainline (IECDAFMT) at 
the point where the message is printed. IECDAFMT returns 
to the caller. 


2 IECDAFMT determines if control blocks are to be IECDAFMT 
formatted. For a call from SNAP/ABDUMP, 

IECDAFMT uses the ABDUMP parameter list to make this 
determination. For print dump (AMDPRDMP), 

IECDAFMT uses the TCB. The input parameter list must 
contain the CVT address, the TCB address, and the system 
whose control blocks are being formatted must be MVS. 

a. IECDAFMT obtains the LOCAL lock if SNAP/ABDUMP IECDAFMT 
is the caller to ensure that the DEB chain does not change 
while it is formatting the DEBs. 


b. If the caller is AMDPRDMP the DEB has already been 
formatted. IECDAFMT only needs a DEB header. 


IECDAFMT FORMATIT 
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IECDAFMT — Data Management Formatter Mainline (Part 4 of 4) 

Extended Description Module Label 

Continued 

C. When the user specified SNAP/ABDUMP with the DM IECDAFMT FORMATIT 
verb, then DCBs and lOBs as well as DEBs are to be 
formatted. When AMDPRDMP is the caller, the TCB 
must have been abended in order to have access to the 
DCBs and lOBs. The TCB has abended if the completion 
code is non-zero and the ABEND in progress flag is one. 

The IECDADCB entry point in IECDAFMT formats 
the OCB. 

d. If a zero return code is returned from the DCB formatter IECDAFMT IOBRTN 

(step 2c), then lOBs (ICBs, LCBs) are to be formatted. 

IECDAFMT invokes the IOB formatter (the IECDAI08 
entry point in IECDAFMT) for each IOB (ICB, LCB). 

e. IECDAFMT scans the DEB chain starting from the TCB. IECDAFMT 

The chain could have changed since the last scan. Once 

a new DEB is found, IECDAFMT releases the LOCAL 
lock and continues to format that DEB at step 2a. 
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IECIOFMT — IOS Formatter Mainline (Part 1 of 6) 


Entered from AMDPRDMP as a TCB exit or from SNAP/ABDUMP 
(10 keyword usage) to format IOS control blocks 



Output 
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IECIOFMT - IOS Formatter Mainline (Part 2 of 6) 

Extended Description Module Label 

AMDPRDMP and SNAP/ABDUMP (when the user specifies 
the 10 verb) call this module as a TCB exit. It locates the 
IOS control blocks (XDB A, UCB) that are to be formatted 
with the appropriate formatter. 

\ IECIOFMTsets up an ESTAE that puts out a message IECIOFMT ESTAERTN 

indicating the abend code for an unexpected error. 

This ESTAE handles expected 0C4 abends, if the invoker 
is SNAP, and retries at the address supplied by the routine 
expecting the abend. If the abend code is not 0C4 (even 
for expected errors), this ESTAE prints the abend message 
and returns control to the caller. 

2 When invoked by AMDPRDMP, IECIOFMT only IECIOFMT IECIOFMT 

formats the control blocks if the completion code in 
the TCB is non-zero or if the TCB abend in progress flag is 
one. When SNAP/ABDUMP is the caller, IECIOFMT always 
formats the IOS control blocks when they are available. 
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IECIOFMT 


IOS Formatter Mainline (Part 3 of 6) 
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IECIOFMT — IOS Formatter Mainline (Part 4 of 6) 


Extended Description Module Label 

3 Using the pointer from the TCB, IECIOFMT places IECIOFMT EXCPDRTN 
the address of the EXCPO (XDBAt in the parameter - 

list passed by the caller and invoices the EXCPD formatter. 

4 IECIOFMT scans the DEB chain looking for the next UCBRTN 

DEB. IECIOFMT starts the scan at the pointer from 

the TCB. The chain couid have been altered since the iast 
scan. 

B. In order to insure the DEB chain does not change while UCBRTN 

it is being.scanned, iEClOFMT obtains the LOCAL 

lock. 

b. Using the addresses from the DEB, IECIOFMT saves the UCBRTN 

pointers to the UCB's in a table to be formatted, even 
if the DEB is taken off the DEB chain while the UCB's 
are being formatted. 

C. IECIOFMT releases the LOCAL lock in order to allow RELLOCK 

I/O processing to continue. 
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IECIOFMT — IOS Formatter Mainline (Part 5 of 6) 


Input 


Process 


Output 
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IECIOFMT - IOS Formatter Mainline 

Extended Description 

d. IECIOFMT calls the UCB formatter (IECIOUCB) for 
each UCB address saved in the table. 

e. IECIOFMT scans the DEB chain looking for the next 
DEB starting from the TCB. If the DEB chain ends prior 
to the next DEB, the scan ends and IECIOFMT returns 
control to the caller. If the DEB chain does not end, 
IECIOFMT selects the next DEB and continues format¬ 
ting UCBs. 

5 At the end of the DEB chain, IECIOFMT returns to 
the caller. 
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IEECB867 - MODULE DESCRIPTION 


DESCRIPTIVE NAME: SVC Dump Reason Code Text Processor 
FUNCTION: 

To use the reason code passed by the caller to 
locate the corresponding text and copy that text 
into the callers buffer. The set of reason codes 
handled by this module are the reason codes 
returned by SVC Dump when a requested dump is 
not taken (SVC Dump return code of 8). 

ENTRY POINT: IEECB867 

PURPOSE: see FUNCTION 

LINKAGE: BALR 

CALLERS: None 

INPUT: 

Two arguments - 

1- reason code 

2- address of the callers buffer 
OUTPUT: None 

EXIT NORMAL: Returns to caller. 

EXTERNAL REFERENCES: 

ROUTINES: IEECB868 
DATA AREAS: 

RCTEXT - table in IEECB868 containing the reason 
code text. 

SERIALIZATION: frfriatever is held by the caller. 
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IEECB867 - MODULE OPERATION 


1. If the reason code is not a valid one, IEECB867 returns 
to the caller with a return code of 4. 

2. If the reason code is a valid one, IEECB867 copies the 
text corresponding to the inputted reason code into the 
callers buffer and then returns to the caller with a 
return code of 0. 
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ZEECB867 - DIAGNOSTIC AIDS 


ENTRY POINT NAME: IEECB867 

MESSAGES: None 

ABEND CODES: None 

WAIT STATE CODES: None 

RETURN CODES: 

EXIT NORMAL: 

0-no error 

4-invalid reason code passed as first argument 


REGISTER CONTENTS ON ENTRY: 

REG 1 - pointer to parameter list 

REG 13 - address of callers 72 byte save area 

REG 14 - return address 

REG 15 - entry point address 


REGISTER CONTENTS ON EXIT: 

EXIT NORMAL: 

R0-R14 are restored 

R15 contains the return code 
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INDEX 


A 

ABDUMP 

processing 

IEAVTABD DMP-82 
abend codes 

issued by SVC dump DMP-8 
ABEND dump processing 
control flow DMP-23 
introduction DMP-3 
abnormal end-of-task termination 
control flow DMP-20 
ASCB (address space control block) 

used to debug SVC dump errors DMP-14 


BRANCH parameter 
SDUMP macro 

usage DMP-7 


CHNGDUMP operator command DMP-4 
console loop trace data 

obtained by IEAVTSDH DMP-116 
control blocks 

formatting specific DMP-5 

used to debug SVC dump errors DMP-14 


data management 

control block formatter DMP-5 
module flow DMP-47 
formatter mainline 
IECDAFMT DMP-164 
data mapping 

ERRWORK DMP-9 
SDEXPARM DMP-9 
debug SVC dump errors 

control blocks used DMP-14 
determining the SVC entry point DMP-8 
diagnostic techniques 

control blocks used to debug SVC dump 
errors DMP-14 
important SVC dump entry 
points DMP-7 

resource cleanup for SVC dump DMP-16 
SVC dump 

debugging aids DMP-7 
error conditions DMP-8 
SYS1.L0GREC entries produced for SVC 
dump errors DMP-9 

DMP 

See dumping services 
DMP (Dumping Services) 

method of operation DMP-49 
DSVCB (DUMPSRV control block) 

used to debug SVC dump errors DMP-15 
dump (formatted) 

module flow DMP-28 
dumping services (DMP) 

ABEND dumps 

introduction DMP-3 


data management control block 
formatter 

module flow DMP-47 
data management formatter mainline 
function DMP-164 
introduction DMP-3 

CHNGDUMP operator command DMP-4 
SVC dump overview DMP-4 
unformatted dump SVC DUMP DMP-4 
IOS control block formatter 
module flow DMP-48 
IOS formatter mainline 
function DMP-168 
master trace dump exit processing 
module flow DMP-45 
resident dump task processing 
function DMP-116 
schedule dump processing 
function DMP-122 
schedule dump SRB processing 
function DMP-130 
scheduled unformatted dump 
module flow DMP-37 
SNAP dump processing 
function DMP-68 
summary dump processing 
function DMP-152 
suspend summary dump processing 
function DMP-160 
SVC post exit processor 
function DMP-134 
SVC summary dump formatter 
module flow DMP-32 
synchronous unformatted dump 
module flow DMP-33 
SYSMDUMP 

introduction DMP-3 
SYSUDUMP 

introduction DMP-3 
DUMPSRV 

address space jobstep task 
IEAVTDSV DMP-92 
resource manager 

IEAVTSDR DMP-110 


entry points for DAE modules 
See module name 
ERRHORK data mapping DMP-9 


fixed data 

Placed in SYS1.L0GREC DMP-9 
formatted 

and unformatted 

ABEND dumps DMP-3 
dump 

module flow DMP-28 
specific control blocks DMP-5 
FRR (functional recovery routine) 
for IEAVTSDB 

logic diagram DMP-108 
module description DMP-94 
functional recovery routine 
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IEAVADIN 

module flow DMP-28 
IEAVAD00 
function 

SVC dump processing DMP-56 
SVC 51 overview DMP-54 
module flow DMP-33 
records in the VRA DMP-9 
IEAVAD01 

function DMP-68 
module flow DMP-28 
IEAVSY50 

posted by IEAVTSDT BMP-118 
posts IEAVTSDX DMP-132 
IEAVTABD 

function DMP-82 
IEAVTDSV 

function DMP-92 
recovery processing DMP-93 
IEAVTFSD 

module flow DMP-32 
IEAVTRTM 

module flow DMP-25 
IEAVTSDB 

diagnostic aids DMP-98 
logic diagram DMP-99 
module description DMP-94 
module operation DMP-96 
recovery operation DMP-96 
resource cleanup DMP-16 
IEAVTSDC 

resource cleanup DMP-16 
IEAVTSDR 

function DMP-110 
resource cleanup DMP-16 
IEAVTSDT 

function DMP-116 
module flow DMP-40, DMP-42 
records in the VRA DMP-9 
IEAVTSDU 

module flow DMP-45 
IEAVTSDX 

function DMP-122, DMP-130 
module flow DMP-37, DMP-38 
records in the VRA DMP-9 
IEAVTSD1 

posts IEAVTSDV DMP-92 
IEAVTSEP 

function DMP-134 
IEAVTSRB 

diagnostic aids DMP-140 
entry point in IEAVTSRB DMP-136 
logic diagram DMP-142 
module description DMP-136 
module operation DMP-137 
IEAVTSSD 

function DMP-152 
records in the VRA DMP-9 
recovery processing DMP-37 
IEAVTSSV 

function DMP-160 
IEA0PT01 

posted by IEAVTSDR DMP-110 
IECDAFMT 

function DMP-164 
module flow DMP-47 
IECIOFMT 

function DMP-168 
module flow DMP-48 
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IEECB867 

diagnostic aids DMP-176 
logic diagram DMP-177 
module description DMP-174 
module operation DMP-175 
IEEMB880 

module flow DMP-45 
IEE0403D 

module flow DMP-46 

important SVC dump entry points DMP-7 
input/output supervisor 
See IOS 
introduction 

dumping services DMP-3 
IOS (I/O supervisor) 

control block formatter DMP-5 
module flow DMP-48 
formatter mainline 
IECIOFMT DMP-168 


key to logic diagrams DMP-49, DMP-50 


L 

logic for DMP DMP-49 


M 

master trace dump exit processing 
module flow DMP-45 
method of operation 
DMP DMP-49 
module flow 
RTM DMP-20 


N 


NDISPSRB 


entry point in IEAVTSDB 

module description DMP-94 
logic diagram DMP-105 


0 

operator command 
CHN6DUMP DMP-4 


P 


post exit processor 
SVC dump 

function DMP-134 


recovery processing 
IEAVTDSV DMP-93 
IEAVTSSD DMP-37 

recovery termination control table 
See RTCT 

recovery termination manager 
See RTM 

resident dump task processing 
IEAVTSDT DMP-116 

resource cleanup for SVC dump DMP-16 
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RSBSRB 

entry point in IEAVTSDB 

module description DMP-94 
logic diagram DMP-100 
RTCT (recovery termination control 
table) 

used to debug SVC dump errors DMP-15 
RTCT extension for SDUMP 
See RTSD 

RTM (recovery termination manager) 

ABDUMP processing DMP-82 
control flow 

for ABEND/SNAP dump 
processing DMP-23 
for abnormal task 
termination DMP-20 
for SVC dump DMP-25 
data management formatter mainline 
function DMP-164 
dumping services 

data management control block 
formatter module flow DMP-47 
formatted dump module flow DMP-28 
10S control block formatter module 
flow DMP-48 

master trace dump exit processing 
module flow DMP-45 
RTM services DMP-46 
scheduled unformatted dump module 
flow DMP-37 

SVC summary dump formatter module 
flow DMP-32 

synchronous unformatted dump, 
module flow DMP-33 
introduction 

ABEND/SNAP dump processing DMP-23 
abnormal end-of-task DMP-3 
data management control block 
formatter DMP-5 
dumping DMP-3 

formatted and unformatted ABEND 
dumps DMP-3 

IOS control block formatter DMP-5 
SVC dump overview DMP-25 
IOS formatter mainline 
function DMP-168 
resident dump task processing 
function DMP-116 
schedule dump processing 
function DMP-122 

schedule dump SRB processing DMP-130 
SNAP dump processing DMP-68 
summary dump processing 
function DMP-152 
suspend summary dump processing 
function DMP-160 
SVC post exit processor 
function DMP-134 
SVC 51 overview DMP-54 
RTM services 

module flow DMP-46 
RTSD (RTCT extension for SDUMP) 

used to debug SVC dump errors DMP-15 


SCHDISRB (label in IEAVTSDX) 
module flow DMP-38 
schedule dump 

options DMP-7 
processing 

IEAVTSDX DMP-122 
SRB processing 


IEAVTSDX DMP-130 
scheduled unformatted dump 
module flow DMP-37 
SCHSRB (label in IEAVTSDX) 
module flow DMP-38 
SDBDIE 

entry point in IEAVTSDB 

module description DMP-94 
logic diagram DMP-101 
SDBFRR 

entry point in IEAVTSDB 

module description DMP-94 
logic diagram DMP-108 
SDDIE (SVC dump DIE control block) 

used to debug SVC dump errors DMP-15 
SDEXPARM data mapping DMP-9 
SDUMP macro 

usage DMP-7 

SDWORK (SVC dump work area) 

used to debug SVC dump errors DMP-15 
SMWK (summary dump work area) 

used to debug SVC dump errors DMP-15 
SNAP 

dump processing 

control flow DMP-23 
IEAVAD01 DMP-68 
used by ABEND dump 

introduction DMP-3 
SRBFRR1 

entry point in IEAVTSRB DMP-136 
SRBFRR2 

entry point in IEAVTSRB DMP-136 
SUMDUMP formatter 

module flow DMP-32 
summary dump 
processing 

IEAVTSSD DMP-152 
summary SVC dump formatter 
module flow DMP-32 
suspend 

summary dump 

processing, IEAVTSSV DMP-160 

SVC 

entry point 

determining the DMP-8 
post exit processor 
function DMP-134 
summary dump formatter 
module flow DMP-32 
13 

module flow DMP-20 
51 

introduction DMP-3 
overview DMP-54 
SVC dump 

/DUMPSRV resource manager 
IEAVTSDR DMP-110 
abend code issued DMP-8 
control blocks used to debug 
errors DMP-14 
debugging aids DMP-7 
error conditions DMP-8 
important entry points DMP-7 
overview 

RTM control flow DMP-25 
overview in RTM DMP-4 
processing 

IEAVADOO DMP-56 
resource cleanup for DMP-16 
title line indicator DMP-8 
synchronous unformatted dump 
module flow DMP-33 
SYSMDUMP 

introduction DMP-3 
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SYSUDUMP 

introduction DMP-3 
SYS1.L06REC 

variable data placed in DMP-9 
SYS1.L0GREC entries produced for SVC 
dump errors DMP-9 


,T. 


V 

variable data 

Placed in SYS1.L0GREC DMP-9 
variable recording area 
See VRA 

VRA (variable recording area) 
data recorded by DMP routines 


title line of SVC dumps 
indicator DMP-8 


unformatted dump 
scheduled 

module flow DMP-37 
SVC dump DMP-4 
synchronous 

module flow DMP-33 


1 

133 abend code 

issued by SVC dump DMP-8 


2 

233 abend code 

issued by SVC dump DMP-8 


DMP-9 
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